비디오 또는 오디오 파일 더빙

제공된 오디오 또는 비디오 파일을 지정된 언어로 더빙합니다.

헤더

xi-api-keystring선택 사항

요청

This endpoint expects a multipart form with multiple files.
filefile선택 사항

음성 복제용 오디오 녹음 파일 경로 목록입니다.

csv_filefile선택 사항

전사/번역 메타데이터가 포함된 CSV 파일

foreground_audio_filefile선택 사항

csv 입력에만 사용

background_audio_filefile선택 사항

csv 입력에만 사용

namestring or null선택 사항

더빙 프로젝트 이름입니다.

source_urlstring or null선택 사항

원본 비디오/오디오 파일의 URL입니다.

source_langstring선택 사항기본값 auto

소스 언어입니다. 유효한 iso639-1 또는 iso639-3 언어 코드를 사용해야 합니다.

target_langstring or null필수

콘텐츠를 더빙할 대상 언어입니다. 유효한 iso639-1 또는 iso639-3 언어 코드가 필요합니다.

target_accentstring or null선택 사항

[실험적 기능] 보이스 라이브러리에서 음성을 선택할 때 적용하고, 선호하는 방언의 번역에 반영할 액센트입니다.

num_speakersinteger선택 사항기본값 0

더빙에 사용할 화자 수입니다. 화자 수를 자동 감지하려면 0으로 설정하세요.

watermarkboolean선택 사항기본값 false

출력 비디오에 워터마크를 적용할지 여부입니다.

start_timeinteger or null선택 사항

소스 비디오/오디오 파일의 시작 시간입니다.

end_timeinteger or null선택 사항

소스 비디오/오디오 파일의 종료 시간입니다.

highest_resolutionboolean선택 사항기본값 false

사용 가능한 최고 해상도를 사용할지 여부입니다.

drop_background_audioboolean선택 사항기본값 false

고급 설정입니다. 최종 더빙에서 배경 오디오를 제거할지 여부입니다. 연설이나 독백처럼 오디오에 배경 트랙이 없어야 하는 경우 더빙 품질을 개선할 수 있습니다.

use_profanity_filterboolean or null선택 사항

[베타] 스크립트의 비속어를 ‘[censored]‘라는 단어로 검열할지 여부입니다.

dubbing_studioboolean선택 사항기본값 false

더빙 스튜디오에서 편집하거나 더빙 리소스로 편집할 수 있도록 더빙을 준비할지 여부입니다.

disable_voice_cloningboolean선택 사항기본값 false
더빙에서 음성 복제를 사용하는 대신 ElevenLabs 보이스 라이브러리의 유사한 음성을 사용합니다. 라이브러리에서 사용하는 음성은 워크스페이스의 사용자 지정 음성 한도에 포함되며, 사용 가능한 슬롯이 부족하면 더빙이 실패합니다. 이 기능을 사용하려면 새 음성에 액세스할 수 있도록 호출자에게 워크스페이스의 'add_voice_from_voice_library' 권한이 있어야 합니다.
modeenum선택 사항기본값 automatic

이 더빙 작업을 실행할 모드입니다. 기본값은 자동이며, 사용할 CSV 트랜스크립트를 직접 제공하는 경우 수동을 사용합니다. 수동 모드는 실험적 기능이므로 프로덕션 환경에서의 사용은 권장하지 않습니다.

허용된 값:
csv_fpsdouble or null선택 사항

더빙용 CSV 파일을 파싱할 때 사용할 초당 프레임 수입니다. 제공하지 않으면 타임코드에서 FPS를 추론합니다.

응답

성공 응답

dubbing_idstring

더빙 프로젝트의 ID입니다.

expected_duration_secdouble

더빙 프로젝트의 예상 길이(초)입니다.

오류

422
Unprocessable Entity Error