Saltar al contenido

API de Mage · Modelo de audio

API de Eleven Speech

ElevenLabs v4: voz realista que puedes dirigir

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

De un vistazo

La API de Eleven Speech ejecuta Eleven v4 a través de Mage en POST https://api.mage.space/v1/eleven_speech/generate. Una solicitud con los ajustes predeterminados cuesta 30 Gems (unos 0,03 $), sin suscripción. Eleven Speech no admite menciones con @handle.

  • AudioResultado
  • 1Variante
  • 30Gems por clip, predeterminado
  • $0.03Aprox., en USD

Resumen

Qué hace la API de Eleven Speech

Texto a voz de ElevenLabs v4 con 16 voces y más de 90 idiomas, dirigido línea por línea con etiquetas de audio como [whispers] o [laughs].

Texto a voz expresivo de ElevenLabs en más de 90 idiomas, en un MP3 tan largo como el texto. Las etiquetas de audio entre corchetes dirigen la entonación y añaden efectos de sonido: [whispers], [laughs], [sarcastic], [door slams].

Genera solo a partir del prompt.

Inicio rápido

Llama a la API de Eleven Speech

Define MAGE_API_KEY, envía la solicitud a /eleven_speech/generate y consulta status_url hasta que termine.

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 de Eleven Speech

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
eleven-v4Eleven v4Sí

Opciones

Parámetros de Eleven Speech

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

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

Reglas

Qué exige la API de Eleven Speech

  • El prompt es el texto que se va a locutar, con un máximo de 5000 caracteres, etiquetas de audio incluidas.
  • `voice` es una de estas: darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt.
  • `stability` va de 0 (expresivo) a 1 (estable).

Más modelos de audio

Otras API de generación de audio en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Eleven Speech?
Una solicitud de Eleven Speech con los ajustes predeterminados (Eleven v4) cuesta 30 Gems, unos 0,03 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la política de contenido de Mage la bloquea, no.
¿Cuál es el endpoint de la API de Eleven Speech?
POST https://api.mage.space/v1/eleven_speech/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url para consultar el resultado.
¿Qué modelos de Eleven Speech puedo usar?
eleven-v4 (Eleven v4). El modelo por defecto es Eleven v4.
¿Eleven Speech admite imágenes de referencia o personajes?
Eleven Speech no admite entradas de imagen, vídeo ni audio. Eleven Speech no admite menciones con @handle.
¿Puedo usar Eleven Speech desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Eleven Speech por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Eleven Speech?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.