더빙 프로젝트 가져오기

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

하위의 모든 언어 대상 ID를 포함한 전체 프로젝트 세부 정보입니다. 프로젝트가 ready 상태가 될 때까지 추적하려면 이 엔드포인트를 폴링하는 대신 webhook_ids 구독을 사용하는 것이 좋습니다.

경로 매개변수

project_idstring필수

가져올 더빙 프로젝트의 식별자입니다.

응답

성공 응답

project_idstring

더빙 프로젝트의 고유 식별자입니다.

statusenum

프로젝트의 수명 주기 상태입니다. 소스를 가져오기 전에는 queued, 트랜스크립션 중에는 preparing, 트랜스크립션이 완료되어 언어 대상이 시작할 수 있으면 ready, 실패 시에는 failed입니다. 프로젝트는 processing으로 보고되지 않으며, 이 값은 언어 대상에 사용됩니다.

허용된 값:

revisioninteger

소스 트랜스크립트가 편집될 때마다(세그먼트 추가/수정/삭제) 증가하는 단조 카운터입니다.

created_atstring형식: "date-time"

프로젝트가 생성된 시점입니다.

updated_atstring형식: "date-time"

프로젝트가 마지막으로 업데이트된 시점입니다.

referencestring or null선택 사항

프로젝트를 만들 때 reference로 제공한 자유 형식 문자열이며, 제공하지 않은 경우 null입니다.

source_languagestring or null선택 사항

소스 미디어의 BCP-47 언어 태그입니다(자동 감지된 경우 null).

model_idstring or null선택 사항

이 프로젝트의 모든 언어 대상에 더빙하는 데 사용되는 더빙 모델입니다. 생성 시 고정되며 언어별로 선택할 수 없습니다.

mediaobject or null선택 사항

소스 미디어 메타데이터입니다. 소스를 가져와 디코딩하면 채워집니다(생성 직후, 프로젝트가 ready 상태가 되기 전). 그전까지는 null입니다.

language_idslist of strings선택 사항기본값 []

이 프로젝트에 속한 대상 언어의 식별자입니다. 단일 프로젝트를 가져올 때와 target_language가 대상 언어를 생성하는 생성 요청에서 채워집니다. 목록 응답에서는 항상 비어 있으므로, 대신 프로젝트의 대상 언어를 나열하세요.

webhook_idslist of strings선택 사항기본값 []

이 프로젝트와 해당 언어가 ready, completed 또는 failed 상태에 도달할 때 알림을 받을 워크스페이스 웹훅의 ID입니다.

errorobject or null선택 사항

프로젝트가 실패한 이유입니다. status가 failed가 아닌 경우 null입니다. 실패 보고가 도입되기 전에 실패한 일부 프로젝트도 null입니다.

warningslist of objects선택 사항

소스를 준비하는 동안 발생한 치명적이지 않은 조건이며, 없으면 비어 있습니다. 최신 준비 상태를 반영합니다. 특정 언어를 더빙하는 동안 발생한 조건은 대신 해당 언어에 보고됩니다.

오류

422

Unprocessable Entity Error

경로 매개변수

헤더

응답

오류