For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
업로드한 파일(`file`) 또는 소스 URL(`source_url`)에서 더빙 프로젝트를 생성합니다.
소스를 가져오기 전, 프로젝트 레코드가 생성되는 즉시 반환됩니다. 프로젝트는 `queued` 상태로 시작하며 소스가 전사되면 `ready` 상태가 됩니다. 원하는 언어마다 언어 대상을 추가하거나, 여기에서 `target_language`를 전달해 첫 번째 대상을 대기열에 추가할 수 있습니다.
프로젝트를 생성하면 최소 1개 언어에 대한 요금이 부과됩니다. 출력이 존재하기 전에도 프로젝트 생성 시 최소 1개 언어의 더빙 비용이 청구됩니다. 이 비용은 첫 번째 언어 대상에 선결제되며, 처음 추가한 대상 또는 `target_language`로 대기열에 추가한 대상이 이를 사용합니다. 추가 언어마다 별도로 요금이 청구됩니다.
소스가 길면 준비에 몇 분이 걸릴 수 있으므로, 폴링하는 대신 프로젝트가 `ready` 또는 `failed` 상태가 될 때 알림을 받도록 `webhook_ids`를 전달하는 것이 좋습니다.
헤더
xi-api-keystring선택 사항
요청
This endpoint expects a multipart form with multiple files.
filefile선택 사항
더빙할 원본 미디어 파일입니다. 최대 3GiB의 오디오 또는 비디오 파일을 사용할 수 있습니다. 이 값과 source_url 중 하나만 제공하세요.
source_urlstring or null선택 사항
서버 측에서 소스 미디어를 가져오는 공개 HTTP(S) URL입니다. 업로드와 동일한 크기 및 형식 제한이 적용됩니다. 이것 또는 file 중 하나만 제공하세요.
referencestring or null선택 사항
사용자 측에서 프로젝트를 식별하기 위한 선택적 자유 형식 문자열(최대 500자)입니다. 있는 그대로 저장되고 반환되며 더빙에는 영향을 주지 않습니다.
source_languagestring or null선택 사항
소스 미디어의 BCP-47 언어 태그입니다. 트랜스크립션 모델이 지원하는 언어여야 합니다. 트랜스크립션은 언어별로 처리되므로 리전 또는 스크립트 하위 태그는 무시됩니다. 자동 감지하려면 생략하세요.
model_idenum or string or null선택 사항
이 프로젝트의 모든 언어 대상에 더빙하는 데 사용할 더빙 모델(`dubbing_v1` 또는 `dubbing_v2`)입니다. 기본값은 `dubbing_v2`입니다. 생성 시 고정되며, 소스가 이 모델용으로 준비되므로 이후 프로젝트나 개별 대상에서 변경할 수 없습니다.
keytermslist of strings선택 사항
트랜스크립션 및 번역에 우선 반영할 핵심 용어입니다(예: 제품명 또는 브랜드명). 최대 1,000개 용어를 지정할 수 있으며, 각 용어는 최대 50자 및 5단어까지 가능합니다. 문자 `<>{}[]\`는 사용할 수 없습니다. 용어의 앞뒤 공백은 제거되고 중복은 제거됩니다. 용어마다 필드를 한 번씩 반복하거나 단일 JSON 배열을 전달하세요.
webhook_idslist of strings선택 사항
이 프로젝트의 진행 상황에 따라 알림을 받을 워크스페이스 웹훅의 ID입니다. 폴링의 대안이며 권장하는 방식입니다. 각 웹훅은 프로젝트에 대해 `dubbing_project_ready` 또는 `dubbing_project_failed` 이벤트를 받고, 그 아래의 각 언어에 대해 `dubbing_language_completed` 또는 `dubbing_language_failed` 이벤트를 받습니다. `dubbing_language_completed`에는 출력 다운로드 URL이 포함됩니다. 최대 3개의 ID를 지정할 수 있으며, 각각 워크스페이스에 이미 구성되어 있어야 합니다. 생성 방법과 서명 검증 방법은 [웹훅](https://elevenlabs.io/docs/eleven-api/resources/webhooks)을 참조하세요. ID마다 필드를 한 번씩 반복하거나 단일 JSON 배열 또는 쉼표로 구분된 문자열을 전달하세요. 전송은 최선의 노력으로 이루어지며 반복될 수 있으므로, 이벤트를 멱등적으로 처리하는 것이 좋습니다.
target_languagestring or null선택 사항
선택적 단축 기능입니다. 이 BCP-47 언어의 언어 대상을 함께 생성하고, 프로젝트가 준비되면 시작하도록 대기열에 추가합니다. 이는 프로젝트를 생성한 후 언어 대상 하나를 생성하는 것과 같습니다. [더빙 모델이 지원하는 언어](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing) 중 하나여야 하며, 지역 한정 태그는 지원되는 방언 중 하나여야 합니다. 이는 첫 번째 언어 대상이므로 비용을 추가하는 대신 프로젝트의 최소 요금이 적용됩니다. 해당 ID는 `language_ids` 로 반환됩니다.
transcriptfile선택 사항
엔터프라이즈 전용입니다. 소스를 트랜스크립션하는 대신 사용할 수 있는 선택적 JSON 트랜스크립트입니다. 최대 20,000개 세그먼트 및 4MiB의 `{"segments": [...]}` 문서입니다. 세그먼트 필드 및 제약 조건은 [자체 트랜스크립트 사용](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript)을 참조하세요. 트랜스크립트를 제공하는 경우에는 항상 `source_language`가 필요합니다. 세그먼트에 `translation`이 포함된 경우 `target_language`가 필요하며 모든 세그먼트에 번역이 있어야 합니다. 이 번역은 `target_language`를 통해 생성된 대상의 초기값으로 사용되며, 이후 기계 번역을 건너뜁니다.
응답
성공 응답
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선택 사항
소스를 준비하는 동안 발생한 치명적이지 않은 조건이며, 없으면 비어 있습니다. 최신 준비 상태를 반영합니다. 특정 언어를 더빙하는 동안 발생한 조건은 대신 해당 언어에 보고됩니다.
업로드한 파일(file) 또는 소스 URL(source_url)에서 더빙 프로젝트를 생성합니다.
소스를 가져오기 전, 프로젝트 레코드가 생성되는 즉시 반환됩니다. 프로젝트는 queued 상태로 시작하며 소스가 전사되면 ready 상태가 됩니다. 원하는 언어마다 언어 대상을 추가하거나, 여기에서 target_language를 전달해 첫 번째 대상을 대기열에 추가할 수 있습니다.
프로젝트를 생성하면 최소 1개 언어에 대한 요금이 부과됩니다. 출력이 존재하기 전에도 프로젝트 생성 시 최소 1개 언어의 더빙 비용이 청구됩니다. 이 비용은 첫 번째 언어 대상에 선결제되며, 처음 추가한 대상 또는 target_language로 대기열에 추가한 대상이 이를 사용합니다. 추가 언어마다 별도로 요금이 청구됩니다.
소스가 길면 준비에 몇 분이 걸릴 수 있으므로, 폴링하는 대신 프로젝트가 ready 또는 failed 상태가 될 때 알림을 받도록 webhook_ids를 전달하는 것이 좋습니다.
이 프로젝트의 모든 언어 대상에 더빙하는 데 사용할 더빙 모델(dubbing_v1 또는 dubbing_v2)입니다. 기본값은 dubbing_v2입니다. 생성 시 고정되며, 소스가 이 모델용으로 준비되므로 이후 프로젝트나 개별 대상에서 변경할 수 없습니다.
트랜스크립션 및 번역에 우선 반영할 핵심 용어입니다(예: 제품명 또는 브랜드명). 최대 1,000개 용어를 지정할 수 있으며, 각 용어는 최대 50자 및 5단어까지 가능합니다. 문자 <>{}[]\는 사용할 수 없습니다. 용어의 앞뒤 공백은 제거되고 중복은 제거됩니다. 용어마다 필드를 한 번씩 반복하거나 단일 JSON 배열을 전달하세요.
이 프로젝트의 진행 상황에 따라 알림을 받을 워크스페이스 웹훅의 ID입니다. 폴링의 대안이며 권장하는 방식입니다. 각 웹훅은 프로젝트에 대해 dubbing_project_ready 또는 dubbing_project_failed 이벤트를 받고, 그 아래의 각 언어에 대해 dubbing_language_completed 또는 dubbing_language_failed 이벤트를 받습니다. dubbing_language_completed에는 출력 다운로드 URL이 포함됩니다. 최대 3개의 ID를 지정할 수 있으며, 각각 워크스페이스에 이미 구성되어 있어야 합니다. 생성 방법과 서명 검증 방법은 웹훅을 참조하세요. ID마다 필드를 한 번씩 반복하거나 단일 JSON 배열 또는 쉼표로 구분된 문자열을 전달하세요. 전송은 최선의 노력으로 이루어지며 반복될 수 있으므로, 이벤트를 멱등적으로 처리하는 것이 좋습니다.
선택적 단축 기능입니다. 이 BCP-47 언어의 언어 대상을 함께 생성하고, 프로젝트가 준비되면 시작하도록 대기열에 추가합니다. 이는 프로젝트를 생성한 후 언어 대상 하나를 생성하는 것과 같습니다. 더빙 모델이 지원하는 언어 중 하나여야 하며, 지역 한정 태그는 지원되는 방언 중 하나여야 합니다. 이는 첫 번째 언어 대상이므로 비용을 추가하는 대신 프로젝트의 최소 요금이 적용됩니다. 해당 ID는 language_ids 로 반환됩니다.
엔터프라이즈 전용입니다. 소스를 트랜스크립션하는 대신 사용할 수 있는 선택적 JSON 트랜스크립트입니다. 최대 20,000개 세그먼트 및 4MiB의 {"segments": [...]} 문서입니다. 세그먼트 필드 및 제약 조건은 자체 트랜스크립트 사용을 참조하세요. 트랜스크립트를 제공하는 경우에는 항상 source_language가 필요합니다. 세그먼트에 translation이 포함된 경우 target_language가 필요하며 모든 세그먼트에 번역이 있어야 합니다. 이 번역은 target_language를 통해 생성된 대상의 초기값으로 사용되며, 이후 기계 번역을 건너뜁니다.
