For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Crea un proyecto de doblaje a partir de un archivo subido (`file`) o una URL de origen (`source_url`).
Devuelve el resultado en cuanto existe el registro del proyecto, antes de recuperar el origen: el proyecto comienza en estado `queued` y pasa a `ready` cuando se ha transcrito su origen. Añade un idioma de destino por cada idioma que quieras, o pasa `target_language` para poner el primero en cola aquí.
La creación de un proyecto conlleva un cargo mínimo de un idioma: se te cobrará el doblaje de al menos un idioma al crear el proyecto, antes de que exista ningún resultado. Este cargo paga por adelantado el primer idioma de destino —el primer destino que añadas o el que pongas en cola mediante `target_language` lo consumirá— y cada idioma adicional se cobra por separado.
La preparación puede tardar varios minutos si el origen es largo, por lo que recomendamos pasar `webhook_ids` para recibir una notificación cuando el proyecto pase a `ready` o `failed`, en lugar de consultarlo periódicamente.
Encabezados
xi-api-keystringOpcional
Solicitud
This endpoint expects a multipart form with multiple files.
filefileOpcional
El archivo multimedia de origen que se va a doblar: un archivo de audio o vídeo de hasta 3 GiB. Proporciona este o source_url, pero no ambos.
source_urlstring or nullOpcional
URL HTTP(S) pública desde la que se obtiene el archivo multimedia de origen en el servidor, sujeta a los mismos límites de tamaño y formato que una subida. Proporciona esta o file, pero no ambas.
referencestring or nullOpcional
Cadena opcional de formato libre (como máximo 500 caracteres) para identificar el proyecto por tu parte. Se almacena y devuelve literalmente; no afecta al doblaje.
source_languagestring or nullOpcional
Etiqueta de idioma BCP-47 del contenido multimedia de origen; debe ser un idioma compatible con el modelo de transcripción. Se ignora cualquier subetiqueta de región o escritura, ya que la transcripción se realiza por idioma. Omítela para detectarlo automáticamente.
model_idenum or string or nullOpcional
Modelo de doblaje (`dubbing_v1` o `dubbing_v2`) con el que se doblan todos los idiomas de destino de este proyecto. El valor predeterminado es `dubbing_v2`. Se fija al crear el proyecto: la fuente se prepara para este modelo, por lo que ni el proyecto ni un destino individual pueden cambiarlo después.
keytermslist of stringsOpcional
Términos clave para orientar la transcripción y la traducción hacia ellos, como nombres de productos o marcas. Se permiten como máximo 1000 términos; cada término puede tener como máximo 50 caracteres y 5 palabras; no se permiten los caracteres `<>{}[]\`. Los términos se recortan y se eliminan los duplicados. Repite el campo una vez por término o pasa un único array JSON.
webhook_idslist of stringsOpcional
ID de los webhooks del espacio de trabajo que se notificarán a medida que avance este proyecto; es la alternativa al sondeo y la que recomendamos. Cada uno recibe un evento `dubbing_project_ready` o `dubbing_project_failed` para el proyecto, y un evento `dubbing_language_completed` o `dubbing_language_failed` para cada idioma incluido; `dubbing_language_completed` contiene las URL de descarga de salida. Como máximo 3 ID, cada uno ya configurado en tu espacio de trabajo; consulta [Webhooks](https://elevenlabs.io/docs/eleven-api/resources/webhooks) para saber cómo crear uno y verificar su firma. Repite el campo una vez por cada ID o proporciona una única matriz JSON o una cadena separada por comas. La entrega se realiza según el mejor esfuerzo y puede repetirse, por lo que recomendamos gestionar los eventos de forma idempotente.
target_languagestring or nullOpcional
Atajo opcional: crea también un idioma de destino en este idioma BCP-47, que se pondrá en cola para iniciarse cuando el proyecto esté listo; equivale a crear el proyecto y después crear un idioma de destino. Debe ser uno de los [idiomas compatibles con el modelo de doblaje](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing), y una etiqueta con región debe ser uno de los dialectos compatibles. Como es el primer idioma de destino, consume el cargo mínimo del proyecto en lugar de añadirse a él. Su ID se devuelve en `language_ids`.
transcriptfileOpcional
Solo Enterprise. Transcripción JSON opcional que se utilizará en lugar de transcribir el contenido de origen: un documento `{"segments": [...]}` con un máximo de 20.000 segmentos y 4 MiB. Consulta [Usa tu propia transcripción](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript) para conocer los campos de los segmentos y sus restricciones. Se requiere `source_language` siempre que se proporcione una transcripción. Si algún segmento incluye una `translation`, se requiere `target_language` y todos los segmentos deben incluir una; esas traducciones inicializan el destino creado mediante `target_language`, que entonces omite la traducción automática.
Respuesta
Respuesta correcta.
project_idstring
Identificador único del proyecto de doblaje.
statusenum
Estado del ciclo de vida del proyecto: queued antes de que se procese la fuente, preparing mientras se transcribe, ready cuando finaliza la transcripción y pueden iniciarse los idiomas de destino, o failed. Un proyecto nunca se indica como processing: ese valor corresponde a los idiomas de destino.
Valores permitidos:
revisioninteger
Contador monotónico que aumenta cada vez que se edita la transcripción de origen (al añadir, editar o eliminar segmentos).
created_atstringformat: "date-time"
Cuándo se creó el proyecto.
updated_atstringformat: "date-time"
Cuándo se actualizó por última vez el proyecto.
referencestring or nullOpcional
La cadena de texto libre que proporcionaste como reference al crear el proyecto, o null si no proporcionaste ninguna.
source_languagestring or nullOpcional
Etiqueta de idioma BCP-47 del contenido multimedia de origen (null si se detecta automáticamente).
model_idstring or nullOpcional
Modelo de doblaje con el que se doblan todos los idiomas de destino de este proyecto. Se fija al crear el proyecto y no se puede seleccionar por idioma.
mediaobject or nullOpcional
Metadatos del contenido multimedia de origen, que se rellenan una vez que el origen se ha obtenido y descodificado (poco después de crear el proyecto y antes de que esté ready); null hasta entonces.
language_idslist of stringsOpcionalValor predeterminado: []
Identificadores de los idiomas de destino de este proyecto. Se rellenan al recuperar un proyecto individual y al crear uno cuando target_language crea uno. Siempre están vacíos en las respuestas de lista; muestra en su lugar los idiomas de destino del proyecto.
webhook_idslist of stringsOpcionalValor predeterminado: []
ID de los webhooks del espacio de trabajo que se notificarán cuando este proyecto y sus idiomas alcancen el estado ready, completed o failed.
errorobject or nullOpcional
Por qué falló el proyecto; null salvo que status sea failed. También es null para los pocos proyectos que fallaron antes de que se introdujera el informe de errores.
warningslist of objectsOpcional
Condiciones no críticas detectadas al preparar la fuente; vacío si no hay ninguna. Refleja la preparación más reciente. Las condiciones detectadas durante el doblaje de un idioma concreto se notifican en ese idioma.
Crea un proyecto de doblaje a partir de un archivo subido (file) o una URL de origen (source_url).
Devuelve el resultado en cuanto existe el registro del proyecto, antes de recuperar el origen: el proyecto comienza en estado queued y pasa a ready cuando se ha transcrito su origen. Añade un idioma de destino por cada idioma que quieras, o pasa target_language para poner el primero en cola aquí.
La creación de un proyecto conlleva un cargo mínimo de un idioma: se te cobrará el doblaje de al menos un idioma al crear el proyecto, antes de que exista ningún resultado. Este cargo paga por adelantado el primer idioma de destino —el primer destino que añadas o el que pongas en cola mediante target_language lo consumirá— y cada idioma adicional se cobra por separado.
La preparación puede tardar varios minutos si el origen es largo, por lo que recomendamos pasar webhook_ids para recibir una notificación cuando el proyecto pase a ready o failed, en lugar de consultarlo periódicamente.
Modelo de doblaje (dubbing_v1 o dubbing_v2) con el que se doblan todos los idiomas de destino de este proyecto. El valor predeterminado es dubbing_v2. Se fija al crear el proyecto: la fuente se prepara para este modelo, por lo que ni el proyecto ni un destino individual pueden cambiarlo después.
Términos clave para orientar la transcripción y la traducción hacia ellos, como nombres de productos o marcas. Se permiten como máximo 1000 términos; cada término puede tener como máximo 50 caracteres y 5 palabras; no se permiten los caracteres <>{}[]\. Los términos se recortan y se eliminan los duplicados. Repite el campo una vez por término o pasa un único array JSON.
ID de los webhooks del espacio de trabajo que se notificarán a medida que avance este proyecto; es la alternativa al sondeo y la que recomendamos. Cada uno recibe un evento dubbing_project_ready o dubbing_project_failed para el proyecto, y un evento dubbing_language_completed o dubbing_language_failed para cada idioma incluido; dubbing_language_completed contiene las URL de descarga de salida. Como máximo 3 ID, cada uno ya configurado en tu espacio de trabajo; consulta Webhooks para saber cómo crear uno y verificar su firma. Repite el campo una vez por cada ID o proporciona una única matriz JSON o una cadena separada por comas. La entrega se realiza según el mejor esfuerzo y puede repetirse, por lo que recomendamos gestionar los eventos de forma idempotente.
Atajo opcional: crea también un idioma de destino en este idioma BCP-47, que se pondrá en cola para iniciarse cuando el proyecto esté listo; equivale a crear el proyecto y después crear un idioma de destino. Debe ser uno de los idiomas compatibles con el modelo de doblaje, y una etiqueta con región debe ser uno de los dialectos compatibles. Como es el primer idioma de destino, consume el cargo mínimo del proyecto en lugar de añadirse a él. Su ID se devuelve en language_ids.
Solo Enterprise. Transcripción JSON opcional que se utilizará en lugar de transcribir el contenido de origen: un documento {"segments": [...]} con un máximo de 20.000 segmentos y 4 MiB. Consulta Usa tu propia transcripción para conocer los campos de los segmentos y sus restricciones. Se requiere source_language siempre que se proporcione una transcripción. Si algún segmento incluye una translation, se requiere target_language y todos los segmentos deben incluir una; esas traducciones inicializan el destino creado mediante target_language, que entonces omite la traducción automática.
