Pobierz projekt dubbingu

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

Pełne szczegóły projektu, w tym ID wszystkich jego celów językowych. Aby śledzić projekt do statusu ready, zalecamy subskrypcję webhook_ids zamiast odpytywania tego endpointu.

Parametry ścieżki

project_idstringWymagany

Identyfikator projektu dubbingu do pobrania.

Odpowiedź

Pomyślna odpowiedź

project_idstring

Unikalny identyfikator projektu dubbingu.

statusenum

Status cyklu życia projektu: queued przed pobraniem źródła, preparing podczas transkrypcji, ready po zakończeniu transkrypcji, gdy można rozpocząć pracę z językami docelowymi, lub failed. Projekt nigdy nie ma statusu processing — ta wartość dotyczy języków docelowych.

Dozwolone wartości:

revisioninteger

Licznik monotoniczny zwiększany przy każdej edycji transkrypcji źródłowej (dodaniu, edycji lub usunięciu segmentu).

created_atstringformat: "date-time"

Kiedy utworzono projekt.

updated_atstringformat: "date-time"

Kiedy ostatnio zaktualizowano projekt.

referencestring or nullOpcjonalny

Dowolny ciąg podany jako reference podczas tworzenia projektu albo null, jeśli go nie podano.

source_languagestring or nullOpcjonalny

Tag językowy BCP-47 materiału źródłowego (null, jeśli wykryto automatycznie).

model_idstring or nullOpcjonalny

Model dubbingu używany dla każdego języka docelowego w tym projekcie. Ustalany podczas tworzenia i niewybieralny dla poszczególnych języków.

mediaobject or nullOpcjonalny

Metadane mediów źródłowych, uzupełniane po pobraniu i zdekodowaniu źródła (krótko po utworzeniu, zanim projekt uzyska status ready); do tego czasu null.

language_idslist of stringsOpcjonalnyDomyślnie []

Identyfikatory języków docelowych w tym projekcie. Uzupełniane podczas pobierania pojedynczego projektu oraz przy tworzeniu, gdy target_language utworzy język docelowy. W odpowiedziach listy zawsze są puste — zamiast tego wyświetl języki docelowe projektu.

webhook_idslist of stringsOpcjonalnyDomyślnie []

ID webhooków workspace powiadamianych, gdy ten projekt i jego języki osiągną status ready, completed lub failed.

errorobject or nullOpcjonalny

Dlaczego projekt się nie powiódł; null, chyba że status ma wartość failed. Również null dla nielicznych projektów, które nie powiodły się przed wprowadzeniem raportowania błędów.

warningslist of objectsOpcjonalny

Niekrytyczne problemy występujące podczas przygotowania źródła; jeśli ich nie ma, lista jest pusta. Odzwierciedla najnowsze przygotowanie. Problemy podczas dubbingu konkretnego języka są zgłaszane dla tego języka.

Błędy

422

Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Odpowiedź

Błędy