Ir al contenido principal

elevenlabs/v4-turbo/text-to-speech

ElevenLabs v4 Turbo convierte un guion de texto en audio de una sola voz mediante el modelo de voz de ElevenLabs enfocado en la latencia. Elige entre 21 voces predefinidas y recoge la grabación terminada en el resultado de la tarea.

Desde $0.048/1.000 caracteres

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "elevenlabs/v4-turbo/text-to-speech",
  "input": {
    "text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
    "language": "auto",
    "voice_id": "Roger",
    "output_format": "mp3_44100_128",
    "text_normalization_mode": "auto"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

textstringObligatorio

Proporciona el guion hablado obligatorio, de hasta 10.000 caracteres. Coloca indicaciones como [whispers] junto a las palabras correspondientes y revisa el texto antes de generar un lote amplio.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
maxLength:10000
seedintegerOpcional

Conserva una seed fija cuando quieras comparar un cambio de guion o ajuste a la vez. Considera el resultado una interpretación nueva, sin esperar audio idéntico.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:4294967295
clone_strengthnumberOpcional

Omite clone_strength en las pruebas con voces predefinidas porque no tiene efecto sobre ellas. Este endpoint no ofrece selección de voces personalizadas o clonadas.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:1
text_normalization_modestringOpcional

Elige auto, on u off para controlar la normalización de números y abreviaturas. Prueba las fechas, los nombres de productos y los códigos reales que vas a publicar, sin asumir que una escritura literal sonará correctamente.

Valor predeterminado
"auto"
Valores permitidos
"auto""on""off"
output_formatstringOpcional

Selecciona entre 9 opciones, con mp3_44100_128 de forma predeterminada y mp3_22050_32 como otra alternativa MP3. Confirma que tu entorno de reproducción admita el formato elegido.

Valor predeterminado
"mp3_44100_128"
Valores permitidos
"mp3_44100_128""mp3_44100_64""mp3_22050_32""opus_48000_128""pcm_24000""pcm_16000""wav_44100""ulaw_8000""alaw_8000"
similarity_boostnumberOpcional

Ajusta similarity_boost al evaluar cómo la interpretación sigue a la voz elegida. Compáralo con las mismas palabras y evita modificar varios controles de voz a la vez.

Valor predeterminado
0.75
Restricciones
minimum:0
maximum:1
stabilitynumberOpcional

Usa stability para ajustar la constancia de la interpretación y escucha una muestra breve. Mantén el guion y la voz sin cambios al comparar ajustes; ningún valor garantiza tomas coincidentes.

Valor predeterminado
0.5
Restricciones
minimum:0
maximum:1
languagestringOpcional

Selecciona auto o uno de los 91 códigos de idioma admitidos. Para un mensaje localizado breve, elige el idioma previsto y proporciona texto ya escrito en él.

Valor predeterminado
"auto"
Valores permitidos
"auto""af""am""ar""hy""as""ast""az""be""bn""bs""bg""my""yue""ca""ceb""hr""cs""da""nl""en""et""fil""fi""fr""ff""gl""ka""de""el""gu""ha""he""hi""hu""is""id""it""ja""jv""kam""kn""kk""ko""ky""lo""lv""ln""lt""lg""lb""mk""ms""ml""mt""zh""mi""mr""mn""ne""no""oc""or""ps""fa""pl""pt""pa""ro""ru""sr""sn""sd""sk""sl""so""ckb""es""sw""sv""tg""ta""te""th""tr""uk""ur""uz""vi""cy""wo""zu"
voice_idstringOpcional

Elige una de las 21 voces predefinidas; si omites la selección se usa Roger. Prueba Sarah, Daniel o Lily con la misma frase breve en vez de proporcionar un identificador de voz personalizado.

Valor predeterminado
"Roger"
Valores permitidos
"Adam""Alice""Bella""Bill""Brian""Callum""Charlie""Chris""Daniel""Eric""George""Harry""Jessica""Laura""Liam""Lily""Matilda""River""Roger""Sarah""Will"

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

Consultar la tarea
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "elevenlabs/v4-turbo/text-to-speech",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp3",
          "mime": "audio/mpeg",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp3?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca ElevenLabs v4 Turbo · Text to Speech en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi