Introducción
Video Translator dobla un clip hablado a otro idioma. Envía el material en video_url y elige target_language; la herramienta transcribe el habla, la traduce, la vuelve a grabar en sincronía con las líneas originales y devuelve la misma imagen con el nuevo audio. Activa clone_voice y cada persona conserva una voz modelada a partir de la suya.
Funciones y aspectos destacados
Las personas siguen sonando como ellas mismas
Con clone_voice activado, el doblaje se habla con una voz construida a partir de la de cada persona: en nuestra prueba con dos personas, la mujer y el hombre salieron en español con su propio timbre, y cada línea empezó donde había empezado la línea original.
Conserva la banda sonora o quítala
keep_background_audio decide qué queda debajo del doblaje. Si está activado, el ambiente de la bodega y el tono de la sala se mantienen exactamente donde estaban. Si está desactivado, el clip devuelto solo lleva las voces traducidas, con silencio real entre las líneas, listo para tu propia mezcla.
Tus nombres siguen siendo tuyos
Enumera términos en glossary como pares {term, translation} y se traducirán a tu manera cada vez. En nuestra prueba, una frase incluida en el glosario se usó tal cual en las dos líneas donde aparecía.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El clip a traducir, de 1 segundo a 10 minutos. La imagen vuelve sin cambios. mínimo 1 caracteres |
target_language | No | El idioma al que se dobla, uno de 28. Por defecto inglés. |
source_language | No | El idioma hablado en el clip. Por defecto auto, que lo detecta. |
clone_voice | No | Desactivado por defecto. Activado: cada persona se vuelve a grabar con una voz modelada a partir de la suya. Valor predeterminado: |
keep_background_audio | No | Activado por defecto: la música y los efectos de sonido se mantienen debajo del doblaje. Desactivado: solo se devuelven las voces traducidas, con silencio entre las líneas. Valor predeterminado: |
speaker_count | No | Cuántas personas hablan en el clip, de 1 a 4. Omítelo para que la herramienta las cuente. |
glossary | No | Nombres, marcas y frases con traducción fija, como pares término / traducción, hasta 100. máximo 100 elementos |
Precios
$0.005 / segundo de salida
Se cobra en minutos completos del clip original, así que un clip de 70 segundos cuesta lo mismo que 2 minutos. El clip debe durar de 1 segundo a 10 minutos; la estimación antes de enviar usa la duración real de un clip que subiste, o el máximo de 10 minutos para una URL de video, y la diferencia se libera al terminar la tarea. Opciones como las voces clonadas o la eliminación del fondo no cambian el precio.
Casos de uso
Localizar video de formato corto
Publica el mismo clip en varios mercados de idioma sin contratar a un actor de voz para cada uno. Los clips de menos de un minuto cuestan un minuto.
Doblar personajes de modelos de video
Los personajes generados que hablan inglés pueden doblarse al idioma de tu público y conservar la voz del personaje.
Guía de prompts y consejos prácticos
Indica el idioma hablado cuando haya música
La detección automática es fiable con habla limpia. En un clip con una guitarra bajo una línea susurrada en francés se rindió y la tarea falló (con reembolso); el mismo clip con source_language en francés funcionó. Si una tarea falla con un mensaje sobre el procesamiento del video, indica source_language y envíala de nuevo.
Dile cuántas personas hablan
speaker_count es opcional, pero indicarlo en un diálogo de dos personas mantiene cada línea con la voz correcta.
Planea para la imagen
Solo se reemplaza el audio. En los primeros planos donde importa la boca, pasa después el clip doblado por la herramienta Lip Sync.
Inicio rápido de la API
# 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": "spicyapi/video-translator-v1/video-translate",
"input": {
"source_language": "auto",
"target_language": "en",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
