GET

/v1/schemas/elevenlabs/audio/v1%2Fmusic%2Fdetailed%2Fstream

kind inputactivity audiohash 901b286d…extracted Nov 5, 2026version currentsource upstream spec ↗

Request body

15 properties · 0 required · 10 $defs
propertytypedescriptionconstraints
promptstringA simple text prompt to generate a song from. Cannot be used in conjunction with `composition_plan`.length ≤ 4100 · nullable
generation_modeenumOptional generation mode hint for prompt-based music generation. Can only be used with `prompt`.track | loop | ambience | video_to_music · nullable
music_promptMusicPromptComposition plan for the `music_v1` model. Using this field with any other model will result in an error.nullable · deprecated
lyrics_textstringThe lyrics text to use for the generation.length ≤ 4000 · nullable
composition_planMusicPrompt | CompositionPlanA detailed composition plan to guide music generation. Cannot be used in conjunction with `prompt`.nullable
music_length_msintegerThe length of the song to generate in milliseconds. Used only in conjunction with `prompt`. Must be between 3000ms and 600000ms. Optional - if not provided, the model will choose a length based on the prompt.3000 ≤ n ≤ 600000 · nullable
model_idenumThe model to use for the generation.music_v1 | music_v2 | music_v2_5 · default: "music_v1"
seedintegerRandom seed to initialize the music generation process. Providing the same seed with the same parameters can help achieve more consistent results, but exact reproducibility is not guaranteed and outputs may change across system updates. Cannot be used in conjunction with prompt.0 ≤ n ≤ 2147483647 · nullable
force_instrumentalbooleanIf 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`.default: false
finetune_idstringThe ID of the finetune to use for the generationlength ≤ 100 · nullable
finetune_strengthnumberHow strongly the finetune influences the generation. Defaults to 1.0 (full strength). Lower values soften the influence of the finetune, leaving more room for prompt-level steering. Only meaningful when `finetune_id` is also provided.0 < n ≤ 2 · default: 1
use_phonetic_namesbooleanIf true, proper names in the prompt will be phonetically spelled in the lyrics for better pronunciation by the music model. The original names will be restored in word timestamps.default: false
store_for_inpaintingbooleanWhether to store the generated song for inpainting.default: false
with_timestampsbooleanWhether to return the timestamps of the words in the generated song.default: false
with_waveform_visualbooleanWhether to return the visual waveform of the generated song.default: false

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"elevenlabs","endpointId":"v1/music/detailed/stream","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}