Esta página es un resumen. La documentación completa, con todos los endpoints y ejemplos reales, está en inglés en soundhalo.com/developers.
Qué hace la API
- Doblaje: envía un audio o un vídeo y recíbelo en otro idioma. Se detiene en un presupuesto y no se genera voz ni se cobra nada hasta que confirmas.
- Transcripción con marcas de tiempo, al momento o como tarea que consultas después.
- Traducción de subtítulos que conserva los tiempos y el orden.
- Texto a voz con 92 voces en 26 idiomas, voz en off a partir de líneas con tiempo y mezcla sobre un vídeo o audio.
- Clonación de tu voz, tras grabar una frase de consentimiento, y sincronización labial (solo caras humanas reales).
- Webhooks firmados y un servidor MCP para Claude, ChatGPT y otras apps de IA.
URL base: https://api.soundhalo.com. Las cantidades de dinero van en microdólares: 1.000.000 = 1 USD. Descripción OpenAPI 3.1: /v1/openapi.json.
Claves de API
- Créalas con tu sesión iniciada en soundhalo.com/es/app/#/developers. Hasta 10 claves activas.
- Una clave empieza por
sh_live_y se muestra una sola vez. SoundHalo solo guarda su huella (un hash), no la clave, y puedes revocarla al instante. - Envíala así:
Authorization: Bearer sh_live_... - Una clave no puede crear ni revocar claves, gestionar webhooks, aprobar accesos MCP ni iniciar pagos (responde
403 FORBIDDEN). Eso se hace en la página con sesión iniciada.
Primeros pasos
Consulta lo que te queda (no cuesta nada):
curl https://api.soundhalo.com/v1/usage/processing \
-H "Authorization: Bearer $SOUNDHALO_API_KEY" Convierte texto en voz (las voces se listan sin clave en GET /v1/generate/speech/voices):
curl https://api.soundhalo.com/v1/generate/speech \
-H "Authorization: Bearer $SOUNDHALO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"text":"Hola, esto es una prueba."},"options":{"voice":"es-dora","format":"mp3"}}' La respuesta incluye output_asset con download_url y asset_token. Descarga el archivo enviando el token en la cabecera x-asset-token.
Doblaje con presupuesto
- Sube el archivo con
POST /v1/assets(multipart, campofile). - Empieza el doblaje con
POST /v1/dubbingy una voz del catálogo (su idioma es el del doblaje),personal(tu voz clonada) uoriginal(la voz de cada persona del archivo, conrights_confirmed: true). - Consulta
GET /v1/dubbing/:idhasta que el estado seaawaiting_confirmation. Verás las líneas traducidas y el presupuesto: segundos facturables, minutos del plan y lo que pagaría tu saldo (quote.balance_micros). El presupuesto dura 24 horas. - Confirma con
POST /v1/dubbing/:id/confirmymax_balance_micros, lo máximo que puede pagar tu saldo. Debe ser al menosquote.balance_micros; si es menor, se rechaza sin cobrar nada. SoundHalo nunca cobra más de lo confirmado. - El doblaje pasa a
generatingy luego asucceeded, con el archivo final enoutput.
Se usan primero los minutos de doblaje del plan y después el saldo, a 0,25 USD por minuto. Audio de hasta 30 minutos y vídeo de hasta 10. Guía completa (en inglés): Dubbing API.
Webhooks
Registra hasta 5 direcciones https en la página de desarrolladores. Eventos: job.completed, job.failed, dub.awaiting_confirmation y balance.topped_up. Cada envío va firmado con el formato Standard Webhooks y se reintenta hasta 8 veces durante unas 45 horas. Cómo verificar la firma, con un ejemplo en Node.js: Webhooks.
Servidor MCP
MCP (Model Context Protocol) es el estándar con el que las apps de IA usan herramientas externas. Conecta tu cuenta en https://api.soundhalo.com/mcp y pide, por ejemplo, que doble un vídeo al inglés. Las acciones de pago siempre muestran antes un presupuesto.
- Claude Code:
claude mcp add --transport http soundhalo https://api.soundhalo.com/mcpy después/mcppara iniciar sesión. También puedes añadir--header "Authorization: Bearer sh_live_...". - Claude.ai y Claude Desktop: Ajustes > Conectores > Añadir conector personalizado, y pega la URL.
- ChatGPT: Ajustes > Apps y conectores, activa el modo desarrollador, elige Crear, pega la URL y usa OAuth.
El inicio de sesión OAuth es el que exigen ChatGPT y Claude.ai: inicias sesión con tu cuenta de SoundHalo y apruebas el acceso, sin copiar claves. Las claves de API son lo más sencillo para Claude Code y scripts. Guía completa: MCP server.
Límites y precios
| Plan | Precio al mes | Minutos de doblaje | Minutos de sincronización labial Standard |
|---|---|---|---|
| Free | 0 USD | 5 | 0 |
| Starter | 5 USD | 30 | 0 |
| Pro | 15 USD | 120 | 5 |
| Creator | 39 USD | 300 | 15 |
| Business | 99 USD | 800 | 35 |
La API usa los mismos límites diarios que la web. Solo el doblaje que supera los minutos del plan y la sincronización labial usan el saldo, y siempre hasta un importe que confirmas. Todos los números por plan y por llamada: Limits and pricing. Precios de los planes: precios.