Recupera progetto di doppiaggio

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

Dettaglio completo del progetto, inclusi gli ID di ogni lingua di destinazione associata. Per seguire un progetto fino a ready, consigliamo una sottoscrizione a webhook_ids invece di effettuare il polling di questo endpoint.

Parametri di percorso

project_idstringObbligatorio

Identificatore del progetto di doppiaggio da recuperare.

Risposta

Risposta riuscita

project_idstring

Identificatore univoco del progetto di doppiaggio.

statusenum

Stato del ciclo di vita del progetto: queued prima che la sorgente venga acquisita, preparing durante la trascrizione, ready quando la trascrizione è completata e le lingue di destinazione possono iniziare, oppure failed. Un progetto non viene mai riportato come processing: questo valore appartiene alle lingue di destinazione.

Valori consentiti:

revisioninteger

Contatore monotono incrementato ogni volta che viene modificata la trascrizione di origine, con l'aggiunta, la modifica o l'eliminazione di un segmento.

created_atstringformat: "date-time"

Quando è stato creato il progetto.

updated_atstringformat: "date-time"

Quando il progetto è stato aggiornato l'ultima volta.

referencestring or nullOpzionale

La stringa in formato libero fornita come reference durante la creazione del progetto, oppure null se non ne hai fornita alcuna.

source_languagestring or nullOpzionale

Tag lingua BCP-47 del media di origine (null se rilevato automaticamente).

model_idstring or nullOpzionale

Modello di doppiaggio usato per doppiare ogni destinazione linguistica di questo progetto. Viene fissato al momento della creazione e non è selezionabile per lingua.

mediaobject or nullOpzionale

Metadati del contenuto multimediale sorgente, popolati dopo che la sorgente è stata recuperata e decodificata, poco dopo la creazione e prima che il progetto sia ready; fino a quel momento, null.

language_idslist of stringsOpzionalePredefinito a []

Identificatori delle lingue di destinazione in questo progetto. Vengono popolati quando si recupera un singolo progetto e alla creazione quando target_language ne crea una. Sono sempre vuoti nelle risposte di elenco: elenca invece le lingue di destinazione del progetto.

webhook_idslist of stringsOpzionalePredefinito a []

ID dei webhook del workspace notificati quando questo progetto e le relative lingue raggiungono lo stato ready, completed o failed.

errorobject or nullOpzionale

Motivo per cui il progetto non è riuscito; null a meno che status non sia failed. È null anche per i pochi progetti non riusciti prima dell'introduzione della segnalazione degli errori.

warningslist of objectsOpzionale

Condizioni non fatali rilevate durante la preparazione dell'origine; è vuoto se non ce ne sono. Riflette l'ultima preparazione. Le condizioni rilevate durante il doppiaggio di una lingua specifica vengono invece riportate per quella lingua.

Errori

422

Unprocessable Entity Error

Parametri di percorso

Header

Risposta

Errori