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:

1# example.py
2from elevenlabs.client import ElevenLabs
3from elevenlabs.play import play
4import os
5from io import BytesIO
6from dotenv import load_dotenv
7load_dotenv()
8
9elevenlabs = ElevenLabs(
10    api_key=os.getenv("ELEVENLABS_API_KEY"),
11)
12
13stream = elevenlabs.music.stream(
14    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.",
15    music_length_ms=10000,
16    model_id="music_v2",
17)
18
19# Create a BytesIO object to hold the audio data in memory
20audio_stream = BytesIO()
21
22# Write each chunk of audio data to the stream
23for chunk in stream:
24    if chunk:
25        audio_stream.write(chunk)
26
27# Reset stream position to the beginning
28audio_stream.seek(0)
29
30play(audio_stream)
2

Execute the code

1python 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.