Obtener proyecto de doblaje

GET

/v1/dubbing/project/:project_id

GET

/v1/dubbing/project/:project_id

curl https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3

{
  "project_id": "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3",
  "status": "ready",
  "revision": 3,
  "created_at": "2026-07-03T10:15:30Z",
  "updated_at": "2026-07-03T10:17:12Z",
  "reference": "Q3 marketing video",
  "source_language": "en",
  "model_id": "dubbing_v2",
  "media": {
    "filename": "promo.mp4",
    "duration_s": 42.5,
    "has_video": true,
    "mime_type": "video/mp4"
  },
  "language_ids": [
    "lang_1001kwkyxp0je6ktn4knsfrasx5s"
  ],
  "webhook_ids": [],
  "warnings": [
    {
      "type": "voices_not_permitted",
      "speaker_ids": [
        "speaker_1"
      ],
      "message": "Voice cloning was not permitted for speaker speaker_1, so a replacement voice was used."
    }
  ]
}

Información completa del proyecto, incluidos los IDs de todos los idiomas de destino que contiene. Para seguir un proyecto hasta ready, recomendamos suscribirte a webhook_ids en lugar de consultar esta ruta de API periódicamente.

Parámetros de ruta

project_idstringRequerido

Identificador del proyecto de doblaje que se recuperará.

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.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Respuesta

Errores