Developer quickstart

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.

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 your first request

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

1
from dotenv import load_dotenv
2
from elevenlabs.client import ElevenLabs
3
from elevenlabs import play
4
5
load_dotenv()
6
7
client = ElevenLabs(
8
  api_key=os.getenv("ELEVENLABS_API_KEY"),
9
)
10
11
audio = client.text_to_speech.convert(
12
    text="The first move is what sets everything in motion.",
13
    voice_id="JBFqnCBsd6RMkjVDRZzb",
14
    model_id="eleven_multilingual_v2",
15
    output_format="mp3_44100_128",
16
)
17
18
play(audio)

Run the code

1
python example.py

You should hear the audio play through your speakers.