ENDPOINTSDubbing

Dub a video or audio file

Dubs a provided audio or video file into given language.

Headers

xi-api-keystringRequired

Request

This endpoint expects a multipart form with multiple files.
filefileOptional
A list of file paths to audio recordings intended for voice cloning
csv_filefileOptional

CSV file containing transcription/translation metadata

foreground_audio_filefileOptional
For use only with csv input
background_audio_filefileOptional
For use only with csv input
namestringOptional
Name of the dubbing project.
source_urlstringOptional

URL of the source video/audio file.

source_langstringOptionalDefaults to auto
Source language.
target_langstringOptional
The Target language to dub the content into.
num_speakersintegerOptionalDefaults to 0
Number of speakers to use for the dubbing. Set to 0 to automatically detect the number of speakers
watermarkbooleanOptionalDefaults to false
Whether to apply watermark to the output video.
start_timeintegerOptional

Start time of the source video/audio file.

end_timeintegerOptional

End time of the source video/audio file.

highest_resolutionbooleanOptionalDefaults to false
Whether to use the highest resolution available.
drop_background_audiobooleanOptionalDefaults to false
An advanced setting. Whether to drop background audio from the final dub. This can improve dub quality where it's known that audio shouldn't have a background track such as for speeches or monologues.
use_profanity_filterbooleanOptional

[BETA] Whether transcripts should have profanities censored with the words ‘[censored]’

dubbing_studiobooleanOptionalDefaults to false
Whether to prepare dub for edits in dubbing studio or edits as a dubbing resource.
disable_voice_cloningbooleanOptionalDefaults to false

[BETA] Instead of using a voice clone in dubbing, use a similar voice from the ElevenLabs Voice Library.

modestringOptionalDefaults to automatic
automatic or manual. Manual mode is only supported when creating a dubbing studio project

Response

Successful Response
dubbing_idstring
The ID of the dubbing project.
expected_duration_secdouble
The expected duration of the dubbing project in seconds.

Errors