Compose music with details

Compose a song from a prompt or a composition plan.

Query parameters

output_formatenumOptionalDefaults to mp3_44100_128

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

Request

This endpoint expects an object.

promptstring or nullOptional<=2000 characters

A simple text prompt to generate a song from. Cannot be used in conjunction with composition_plan.

composition_planobject or nullOptional

A detailed composition plan to guide music generation. Cannot be used in conjunction with prompt.

music_length_msinteger or nullOptional>=3000<=300000

The length of the song to generate in milliseconds. Used only in conjunction with prompt. Must be between 3000ms and 300000ms. Optional - if not provided, the model will choose a length based on the prompt.

model_idenumOptionalDefaults to music_v1

The model to use for the generation.

Allowed values:

force_instrumentalbooleanOptionalDefaults to false

If true, guarantees that the generated song will be instrumental. If false, the song may or may not be instrumental depending on the prompt. Can only be used with prompt.

store_for_inpaintingbooleanOptionalDefaults to false

Whether to store the generated song for inpainting. Only available to enterprise clients with access to the inpainting API.

Response

Multipart/mixed response with JSON metadata and binary audio file

1	from elevenlabs import ElevenLabs
2
3	client = ElevenLabs(
4	base_url="https://api.elevenlabs.io"
5	)
6
7	client.music.compose_detailed(
8	prompt="A prompt for music generation",
9	music_length_ms=10000
10	)

1	{
2	"composition_plan": {
3	"positive_global_styles": [
4	"pop",
5	"rock",
6	"jazz"
7	],
8	"negative_global_styles": [
9	"metal",
10	"hip-hop",
11	"country"
12	],
13	"sections": [
14	{
15	"section_name": "Verse 1",
16	"positive_local_styles": [
17	"pop",
18	"rock",
19	"jazz"
20	],
21	"negative_local_styles": [
22	"metal",
23	"hip-hop",
24	"country"
25	],
26	"duration_ms": 10000,
27	"lines": [
28	"Verse 1 lyrics"
29	]
30	}
31	]
32	},
33	"song_metadata": {
34	"title": "My Song",
35	"description": "My Song Description",
36	"genres": [
37	"pop",
38	"rock",
39	"jazz"
40	],
41	"languages": [
42	"en",
43	"fr"
44	],
45	"is_explicit": false
46	},
47	"audio": "[binary audio data]"
48	}

Headers

Query parameters

Request

Response

Errors