Sound Effects 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 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
7
load_dotenv()
8
9
elevenlabs = ElevenLabs(
10
  api_key=os.getenv("ELEVENLABS_API_KEY"),
11
)
12
audio = elevenlabs.text_to_sound_effects.convert(text="Cinematic Braam, Horror")
13
14
play(audio)

Execute the code

1
python example.py

You should hear your generated sound effect playing through your speakers.