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.
filestringOptionalformat: "binary"

A list of file paths to audio recordings intended for voice cloning

csv_filestringOptionalformat: "binary"

CSV file containing transcription/translation metadata

foreground_audio_filestringOptionalformat: "binary"

For use only with csv input

background_audio_filestringOptionalformat: "binary"

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.

modestringOptional

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