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