ElevenAPIDubbingLanguage targets

더빙 대상 언어 생성

프로젝트에 더빙할 언어를 추가하고 더빙을 대기열에 등록합니다. 이 호출은 더빙된 오디오를 생성하며, 생성 단위로 요금이 청구됩니다. 대상은 `queued` 상태로 생성되고 프로젝트가 `ready` 상태가 되는 즉시 시작되므로, 프로젝트 생성 후 언제든 추가할 수 있습니다. 프로젝트의 더빙 모델을 상속하며 다른 모델을 선택할 수 없습니다. `webhook_ids`로 생성된 프로젝트는 출력 다운로드 URL이 포함된 `dubbing_language_completed` 이벤트를 전송하므로, 이 대상이 완료될 때까지 폴링하는 대신 구독하는 것을 권장합니다.

경로 매개변수

project_idstring필수

상위 더빙 프로젝트의 식별자입니다.

헤더

xi-api-keystring선택 사항

요청

This endpoint expects an object.
target_languagestring필수

프로젝트를 더빙할 언어의 BCP-47 언어 태그입니다(예: fr 또는 es-MX). 프로젝트의 더빙 모델이 지원하는 언어 중 하나여야 하며, 리전이 지정된 태그는 지원되는 방언 중 하나여야 합니다.

voice_settingsobject or null선택 사항

이 언어의 모든 화자에게 적용되는 음성 설정입니다. 기본 설정을 사용하려면 생략하세요.

translationsmap from strings to strings or null선택 사항

엔터프라이즈 전용입니다. 기계 번역 대신 사용할 선택적 번역입니다. 각 소스 세그먼트의 external_id(제공하지 않은 경우 id)와 번역 텍스트 간의 매핑이며, 모든 소스 세그먼트가 정확히 한 번씩 포함되어야 합니다. 최대 20,000개 항목, 총 텍스트 크기 최대 4MiB입니다. 자체 트랜스크립트 사용을 참조하세요.

응답

성공 응답

language_idstring

언어 대상의 고유 식별자입니다.

project_idstring

상위 더빙 프로젝트의 식별자입니다.

target_languagestring

이 대상이 더빙되는 언어의 BCP-47 언어 태그입니다.

statusenum

수명 주기 상태입니다. 프로젝트 준비 또는 워커를 기다리는 동안에는 queued, 더빙 중에는 processing, 출력이 준비되면 completed, 출력 생성 후 트랜스크립트가 변경되면 stale, 실패 시에는 failed입니다.

허용된 값:
revisioninteger

이 대상의 트랜스크립트가 변경될 때마다(영향을 주는 소스 편집 또는 번역 편집) 증가하는 단조 카운터입니다.

created_atstring형식: "date-time"

언어 대상이 생성된 시점입니다.

updated_atstring형식: "date-time"

언어 대상이 마지막으로 업데이트된 시점입니다.

model_idstring or null선택 사항

이 대상에 더빙하는 데 사용되는 모델입니다. 프로젝트에서 상속되며 언어별로 선택할 수 없습니다.

voice_settingsobject or null선택 사항

이 언어의 모든 화자에게 적용되는 음성 설정입니다. 기본 설정이 적용되는 경우 null입니다.

outputsobject or null선택 사항

서명된 출력 URL입니다. 대상이 출력을 생성할 때까지는 null이며, completed가 되면 제공되고 stale 상태에서도 유지됩니다. 출력이 최신 상태인지 확인하려면 output_revision과 revision을 비교하세요.

output_revisioninteger or null선택 사항

현재 더빙 출력이 생성된 revision입니다. 최신 상태이면 revision과 같고, stale 상태이면 더 낮습니다. 생성이 완료될 때까지는 null입니다.

errorobject or null선택 사항

이 언어가 실패한 이유입니다. status가 failed가 아닌 경우 null이며, 실패 보고가 도입되기 전에 실패한 일부 언어도 null입니다. 코드가 project_failed이면 상위 프로젝트가 실패했음을 의미하므로 근본 원인은 프로젝트를 확인하세요.

warningslist of objects선택 사항

이 언어를 더빙하는 동안 발생한 치명적이지 않은 조건이며, 없으면 비어 있습니다. 최신 생성을 반영합니다. 소스를 준비하는 동안 발생한 조건은 대신 프로젝트에 보고됩니다.

오류

422
Unprocessable Entity Error