Instant Voice Cloning | ElevenLabs Documentation

This guide will show you how to create an Instant Voice Clone using the Clone Voice API. To create an Instant Voice Clone via the dashboard, refer to the Instant Voice Clone product guide.

For an outline of the differences between Instant Voice Clones and Professional Voice Clones, refer to the Voices capability guide.

Using the Instant Voice Clone 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

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 io import BytesIO
6 
7 load_dotenv()
8 
9 client = ElevenLabs(
10   api_key=os.getenv("ELEVENLABS_API_KEY"),
11 )
12 
13 voice = client.voices.add(
14     name="My Voice Clone",
15     # Replace with the paths to your audio files.
16     # The more files you add, the better the clone will be.
17     files=[BytesIO(open("/path/to/your/audio/file.mp3", "rb").read())]
18 )
19 
20 print(voice.voice_id)

Execute the code

1 python example.py

You should see the voice ID printed to the console.

Next steps

Explore the API reference for more information on creating a voice clone.