How-to guidesMusic

Music streaming

This guide shows you how to stream music with our Music API.

How-to guide · Assumes you have completed the Music quickstart.

The Music API is only available to paid users.

Using the Music API

This guide assumes you have set up your API key and SDK. Complete the quickstart first if you haven’t.

1

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:

# example.py
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
from io import BytesIO
from dotenv import load_dotenv
load_dotenv()
elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)
stream = elevenlabs.music.stream(
    prompt="Create an intense, fast-paced electronic track for a high-adrenaline video game scene. Use driving synth arpeggios, punchy drums, distorted bass, glitch effects, and aggressive rhythmic textures. The tempo should be fast, 130–150 bpm, with rising tension, quick transitions, and dynamic energy bursts.",
    music_length_ms=10000,
    model_id="music_v2_5",
)
# Create a BytesIO object to hold the audio data in memory
audio_stream = BytesIO()
# Write each chunk of audio data to the stream
for chunk in stream:
    if chunk:
        audio_stream.write(chunk)
# Reset stream position to the beginning
audio_stream.seek(0)
play(audio_stream)
2

Execute the code

python example.py

You should hear the generated music playing.

Next steps

Composition plans

Use composition plans to structure and control how music is generated.

Music inpainting

Edit and blend sections of existing tracks with new generations.