Dub Video/Audio File

Dubs provided audio or video file into given language.

Python

from elevenlabs.client import ElevenLabs
import requests
from io import BytesIO

client = ElevenLabs()

target_lang = "es"  # Spanish

audio_url = (
    "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
)
response = requests.get(audio_url)

audio_data = BytesIO(response.content)
audio_data.name = "audio.mp3"

# Start dubbing
dubbed = client.dubbing.dub_a_video_or_an_audio_file(
    file=audio_data, target_lang=target_lang
)

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

file · file

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

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.

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.

drop_background_audio · boolean · default: 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_filter · boolean

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

Response

200

application/json

Successful Response

dubbing_id · string · required

expected_duration_sec · number · required