Music quickstart

1
from elevenlabs.client import ElevenLabs
2
from elevenlabs.play import play
3
import os
4
from dotenv import load_dotenv
5
load_dotenv()
6
7
elevenlabs = ElevenLabs(
8
api_key=os.getenv("ELEVENLABS_API_KEY"),
9
)
10
11
composition_plan = elevenlabs.music.composition_plan.create(
12
    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.",
13
    music_length_ms=10000,
14
)
15
16
print(composition_plan)

1
# You can pass in composition_plan or prompt, but not both.
2
composition = elevenlabs.music.compose(
3
    composition_plan=composition_plan,
4
)
5
6
play(composition)

1
track_details = elevenlabs.music.compose_detailed(
2
    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.",
3
    music_length_ms=10000,
4
)
5
6
print(track_details.json) # json contains composition_plan and song_metadata. The composition plan will include lyrics (if applicable)
7
print(track_details.filename)
8
# track_details.audio contains the audio bytes

1
try:
2
    # This will result in a bad_prompt error
3
    track = elevenlabs.music.compose(
4
        prompt="A song that sounds like 'Bohemian Rhapsody'",
5
        music_length_ms=10000,
6
    )
7
  except Exception as e:
8
      if e.body['detail']['status'] == 'bad_prompt':
9
          prompt_suggestion = e.body['detail']['data']['prompt_suggestion']
10
          print(prompt_suggestion) # Prints: An epic rock ballad with dramatic tempo changes, operatic harmonies, and a narrative structure that blends melancholy with bursts of theatrical intensity.
11
12
          # Use the prompt suggestion to generate the track instead