For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
LogoLogo
Login
Login
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • API reference
    • Introduction
    • Authentication
    • Streaming
  • ElevenAgents
  • ElevenAPI
      • POSTCompose music
      • STREAMStream music
      • POSTCompose music with details
      • POSTCreate composition plan
      • POSTVideo To Music
      • POSTUpload Music
      • POSTStem Separation
  • ElevenCreative
  • Core Resources
  • Workspace
  • Legacy
Connect
BlogHelp CenterAPI PricingSign up
ElevenAPIMusic

Create composition plan

POST
/v1/music/plan
POST
/v1/music/plan
$curl -X POST https://api.elevenlabs.io/v1/music/plan \
>     -H "Content-Type: application/json" \
>     -d '{
>  "prompt": "string"
>}'
1{
2  "positive_global_styles": [
3    "pop",
4    "rock",
5    "jazz"
6  ],
7  "negative_global_styles": [
8    "metal",
9    "hip-hop",
10    "country"
11  ],
12  "sections": [
13    {
14      "section_name": "Verse 1",
15      "positive_local_styles": [
16        "pop",
17        "rock",
18        "jazz"
19      ],
20      "negative_local_styles": [
21        "metal",
22        "hip-hop",
23        "country"
24      ],
25      "duration_ms": 10000,
26      "lines": [
27        "Verse 1 lyrics"
28      ]
29    }
30  ]
31}
Create a composition plan for music generation. Usage of this endpoint does not cost any credits but is subject to rate limiting depending on your tier.
Was this page helpful?
Previous

Video To Music

Next
Built with

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
promptstringRequired<=4100 characters
A simple text prompt to compose a plan from.
music_length_msinteger or nullOptional3000-600000

The length of the composition plan to generate in milliseconds. Must be between 3000ms and 600000ms. Optional - if not provided, the model will choose a length based on the prompt.

source_composition_planobject or nullOptional
An optional composition plan to use as a source for the new composition plan.
model_idenumOptionalDefaults to music_v1
The model to use for the generation.
Allowed values:

Response

Successful Response
positive_global_styleslist of strings
The styles and musical directions that should be present in the entire song. Use English language for best result.
negative_global_styleslist of strings
The styles and musical directions that should not be present in the entire song. Use English language for best result.
sectionslist of objects
The sections of the song.

Errors

422
Unprocessable Entity Error