Desarrolladores

API de SoundHalo

Dobla, pon voz, traduce y transcribe audio y vídeo desde tu código o desde un asistente de IA. Una clave de API actúa como tu cuenta: usa los mismos minutos del plan, el mismo saldo y los mismos límites que las herramientas de la web.

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):

uso
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):

texto a voz
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

  1. Sube el archivo con POST /v1/assets (multipart, campo file).
  2. Empieza el doblaje con POST /v1/dubbing y una voz del catálogo (su idioma es el del doblaje), personal (tu voz clonada) u original (la voz de cada persona del archivo, con rights_confirmed: true).
  3. Consulta GET /v1/dubbing/:id hasta que el estado sea awaiting_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.
  4. Confirma con POST /v1/dubbing/:id/confirm y max_balance_micros, lo máximo que puede pagar tu saldo. Debe ser al menos quote.balance_micros; si es menor, se rechaza sin cobrar nada. SoundHalo nunca cobra más de lo confirmado.
  5. El doblaje pasa a generating y luego a succeeded, con el archivo final en output.

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/mcp y después /mcp para 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

PlanPrecio al mesMinutos de doblajeMinutos de sincronización labial Standard
Free0 USD50
Starter5 USD300
Pro15 USD1205
Creator39 USD30015
Business99 USD80035

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.