Dubbing quickstart

Learn how to dub audio and video files across languages using the Dubbing API.

Using the Dubbing API

Create an API key

Create an API key in the dashboard here, which you’ll use to securely access the API.

Store the key as a managed secret and pass it to the SDKs either as a environment variable via an .env file, or directly in your app’s configuration depending on your preference.

.env

1 ELEVENLABS_API_KEY=<your_api_key_here>

Install the SDK

We’ll also use the dotenv library to load our API key from an environment variable.

1 pip install elevenlabs
2 pip install python-dotenv

To play the audio through your speakers, you may be prompted to install MPV and/or ffmpeg.

Make the API request

Create a new file named example.py or example.mts, depending on your language of choice and add the following code:

1 # example.py
2 import os
3 from dotenv import load_dotenv
4 from elevenlabs.client import ElevenLabs
5 from elevenlabs.play import play
6 import requests
7 from io import BytesIO
8 import time
9 
10 load_dotenv()
11 
12 elevenlabs = ElevenLabs(
13   api_key=os.getenv("ELEVENLABS_API_KEY"),
14 )
15 
16 target_lang = "es"  # Spanish
17 
18 audio_url = (
19     "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
20 )
21 response = requests.get(audio_url)
22 
23 audio_data = BytesIO(response.content)
24 audio_data.name = "audio.mp3"
25 
26 # Start dubbing
27 dubbed = elevenlabs.dubbing.create(
28     file=audio_data, target_lang=target_lang
29 )
30 
31 while True:
32     status = elevenlabs.dubbing.get(dubbed.dubbing_id).status
33     if status == "dubbed":
34         dubbed_file = elevenlabs.dubbing.audio.get(dubbed.dubbing_id, target_lang)
35         play(dubbed_file)
36         break
37     else:
38         print("Audio is still being dubbed...")
39         time.sleep(5)

Execute the code

1 python example.py

You should hear the dubbed audio file playing through your speakers.

Using the Dubbing API

Create an API key

Create an API key in the dashboard here, which you’ll use to securely access the API.

Store the key as a managed secret and pass it to the SDKs either as a environment variable via an .env file, or directly in your app’s configuration depending on your preference.

.env

1 ELEVENLABS_API_KEY=<your_api_key_here>

Install the SDK

We’ll also use the dotenv library to load our API key from an environment variable.

1 pip install elevenlabs
2 pip install python-dotenv

To play the audio through your speakers, you may be prompted to install MPV and/or ffmpeg.

Make the API request

Create a new file named example.py or example.mts, depending on your language of choice and add the following code:

1 # example.py
2 import os
3 from dotenv import load_dotenv
4 from elevenlabs.client import ElevenLabs
5 from elevenlabs.play import play
6 import requests
7 from io import BytesIO
8 import time
9 
10 load_dotenv()
11 
12 elevenlabs = ElevenLabs(
13   api_key=os.getenv("ELEVENLABS_API_KEY"),
14 )
15 
16 target_lang = "es"  # Spanish
17 
18 audio_url = (
19     "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
20 )
21 response = requests.get(audio_url)
22 
23 audio_data = BytesIO(response.content)
24 audio_data.name = "audio.mp3"
25 
26 # Start dubbing
27 dubbed = elevenlabs.dubbing.create(
28     file=audio_data, target_lang=target_lang
29 )
30 
31 while True:
32     status = elevenlabs.dubbing.get(dubbed.dubbing_id).status
33     if status == "dubbed":
34         dubbed_file = elevenlabs.dubbing.audio.get(dubbed.dubbing_id, target_lang)
35         play(dubbed_file)
36         break
37     else:
38         print("Audio is still being dubbed...")
39         time.sleep(5)

Execute the code

1 python example.py

You should hear the dubbed audio file playing through your speakers.

Dubbing quickstart

Dubbing quickstart

Using the Dubbing API

Create an API key

Install the SDK

Make the API request

Execute the code

Next steps

Using the Dubbing API

Create an API key

Install the SDK

Make the API request

Execute the code

Next steps

1	# example.py
2	import os
3	from dotenv import load_dotenv
4	from elevenlabs.client import ElevenLabs
5	from elevenlabs.play import play
6	import requests
7	from io import BytesIO
8	import time
9
10	load_dotenv()
11
12	elevenlabs = ElevenLabs(
13	api_key=os.getenv("ELEVENLABS_API_KEY"),
14	)
15
16	target_lang = "es" # Spanish
17
18	audio_url = (
19	"https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
20	)
21	response = requests.get(audio_url)
22
23	audio_data = BytesIO(response.content)
24	audio_data.name = "audio.mp3"
25
26	# Start dubbing
27	dubbed = elevenlabs.dubbing.create(
28	file=audio_data, target_lang=target_lang
29	)
30
31	while True:
32	status = elevenlabs.dubbing.get(dubbed.dubbing_id).status
33	if status == "dubbed":
34	dubbed_file = elevenlabs.dubbing.audio.get(dubbed.dubbing_id, target_lang)
35	play(dubbed_file)
36	break
37	else:
38	print("Audio is still being dubbed...")
39	time.sleep(5)