Obter projeto de dublagem

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."
    }
  ]
}

Detalhes completos do projeto, incluindo os IDs de cada destino de idioma nele. Para acompanhar um projeto até ready, recomendamos uma assinatura de webhook_ids em vez de consultar este endpoint repetidamente.

Parâmetros de caminho

project_idstringObrigatório

Identificador do projeto de dublagem a ser recuperado.

Resposta

Resposta bem-sucedida

project_idstring

Identificador exclusivo do projeto de dublagem.

statusenum

Status do ciclo de vida do projeto: queued antes que a fonte seja processada, preparing durante a transcrição, ready quando a transcrição estiver concluída e os idiomas de destino puderem ser iniciados, ou failed. Um projeto nunca é informado como processing — esse valor pertence aos idiomas de destino.

Valores permitidos:

revisioninteger

Contador monotônico incrementado sempre que a transcrição de origem é editada (adição/edição/exclusão de segmento).

created_atstringformat: "date-time"

Quando o projeto foi criado.

updated_atstringformat: "date-time"

Quando o projeto foi atualizado pela última vez.

referencestring or nullOpcional

A string de formato livre fornecida como reference ao criar o projeto, ou null se nenhuma tiver sido fornecida.

source_languagestring or nullOpcional

Tag de idioma BCP-47 da mídia de origem (null se detectado automaticamente).

model_idstring or nullOpcional

Modelo de dublagem usado para dublar todos os idiomas de destino deste projeto. É definido no momento da criação e não pode ser selecionado por idioma.

mediaobject or nullOpcional

Metadados da mídia de origem, preenchidos quando a origem tiver sido buscada e decodificada (pouco após a criação, antes de o projeto estar ready); null até então.

language_idslist of stringsOpcionalPadrão é []

Identificadores dos idiomas de destino deste projeto. Preenchidos ao recuperar um único projeto e na criação, quando target_language cria um. Sempre vazio nas respostas de lista — liste os idiomas de destino do projeto.

webhook_idslist of stringsOpcionalPadrão é []

IDs dos webhooks do workspace notificados quando este projeto e seus idiomas alcançam ready, completed ou failed.

errorobject or nullOpcional

Por que o projeto falhou; null, a menos que status seja failed. Também é null para os poucos projetos que falharam antes da introdução do relatório de falhas.

warningslist of objectsOpcional

Condições não fatais identificadas durante a preparação da fonte; fica vazio quando não há nenhuma. Reflete a preparação mais recente. As condições identificadas durante a dublagem de um idioma específico são relatadas nesse idioma.

Erros

422

Unprocessable Entity Error

Parâmetros de caminho

Cabeçalhos

Resposta

Erros