Pular para o conteúdo

API do Mage · Modelo de áudio

API Eleven Speech

ElevenLabs v4: fala realista que você pode dirigir

POST https://api.mage.space/v1/eleven_speech/generate

Resumo rápido

A API Eleven Speech executa o Eleven v4 pelo Mage em POST https://api.mage.space/v1/eleven_speech/generate. Uma requisição com as configurações padrão custa 30 Gems (cerca de US$ 0,03), sem assinatura. O Eleven Speech não aceita menções com @handle.

  • ÁudioSaída
  • 1Variante
  • 30Gems por clipe, padrão
  • $0.03Aproximadamente, em USD

Visão geral

O que a API Eleven Speech faz

Conversão de texto em fala do ElevenLabs v4 com 16 vozes e mais de 90 idiomas, dirigida linha por linha com tags de áudio como [whispers] ou [laughs].

A conversão de texto em fala expressiva da ElevenLabs em mais de 90 idiomas, em um MP3 com a duração do texto. Tags de áudio entre colchetes dirigem a entrega e adicionam efeitos sonoros: [whispers], [laughs], [sarcastic], [door slams].

Ele gera apenas a partir do prompt.

Início rápido

Chame a API Eleven Speech

Defina MAGE_API_KEY, envie para /eleven_speech/generate e consulte status_url até a solicitação ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
  "model_id": "eleven-v4"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('eleven_speech', {
  prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
  model_id: 'eleven-v4',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("eleven_speech", {
    "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
    "model_id": "eleven-v4",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Eleven Speech

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
eleven-v4Eleven v4Sim

Opções

Parâmetros do Eleven Speech

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
voicedarian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt

Regras

O que a API Eleven Speech impõe

  • O prompt é o texto a ser falado, com no máximo 5000 caracteres, incluindo as tags de áudio.
  • `voice` é uma destas: darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt.
  • `stability` vai de 0 (expressivo) a 1 (estável).

Mais modelos de áudio

Outras APIs de geração de áudio no Mage

  • Áudio · a partir de 19 Gems

    API do Seed Audio

    Vozes, música e efeitos sonoros a partir de um único prompt

  • Áudio · a partir de 113 Gems

    API do Eleven Music

    Músicas da ElevenLabs, com ou sem vocais

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Eleven Speech?
Uma requisição ao Eleven Speech com as configurações padrão (Eleven v4) custa 30 Gems, cerca de US$ 0,03. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Eleven Speech?
POST https://api.mage.space/v1/eleven_speech/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui uma status_url para consultar o resultado.
Quais modelos do Eleven Speech posso usar?
eleven-v4 (Eleven v4). O padrão é o Eleven v4.
O Eleven Speech aceita imagens de referência ou personagens?
O Eleven Speech não aceita entradas de imagem, vídeo ou áudio. O Eleven Speech não aceita menções com @handle.
Posso usar o Eleven Speech no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Eleven Speech pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Eleven Speech ficam guardados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.