POST
/
v1
/
dubbing
curl --request POST \
  --url https://api.elevenlabs.io/v1/dubbing \
  --header 'Content-Type: multipart/form-data' \
  --form 'mode=<string>' \
  --form 'file=<string>' \
  --form 'csv_file=<string>' \
  --form 'foreground_audio_file=<string>' \
  --form 'background_audio_file=<string>' \
  --form 'name=<string>' \
  --form 'source_url=<string>' \
  --form 'source_lang=<string>' \
  --form 'target_lang=<string>' \
  --form num_speakers=123 \
  --form watermark=true \
  --form start_time=123 \
  --form end_time=123 \
  --form highest_resolution=true \
  --form dubbing_studio=true
{
  "dubbing_id": "<string>",
  "expected_duration_sec": 123
}
Dubbing API avaliable upon request. To get access, contact sales.

​
Creating dubs using our API

In order to create dubs using our API be sure to set mode="automatic", and upload your file to be dubbed using the file parameter. At this time automated dubbing doesn’t support automatically dubbing from a csv_file/foreground_file/background_file.

Headers

xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Body

multipart/form-data
mode
string

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

file
string

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

csv_file
string

CSV file containing transcription/translation metadata

foreground_audio_file
string

For use only with csv input

background_audio_file
string

For use only with csv input

name
string

Name of the dubbing project.

source_url
string

URL of the source video/audio file.

source_lang
string
default: auto

Source language.

target_lang
string

The Target language to dub the content into. Can be none if dubbing studio editor is enabled and running manual mode

num_speakers
integer
default: 0

Number of speakers to use for the dubbing. Set to 0 to automatically detect the number of speakers

watermark
boolean
default: false

Whether to apply watermark to the output video.

start_time
integer

Start time of the source video/audio file.

end_time
integer

End time of the source video/audio file.

highest_resolution
boolean
default: false

Whether to use the highest resolution available.

dubbing_studio
boolean
default: false

Whether to prepare dub for edits in dubbing studio.

Response

200 - application/json
dubbing_id
string
required
expected_duration_sec
number
required
Creates Audionative Enabled Project.Get Dubbing Project Metadata