GET

/v1/schemas/elevenlabs/audio/v1/music/upload

Accept:

kind inputactivity audiohash 8083bbd7…extracted Nov 5, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `1fbf939a1e97e541ce9b5f19ec2b8c81cd5610fb4b8426c6bb70fc579f32679f` { "fetchedAt": 1793856031, "extractorVersion": "1", "verifiedAt": null }

Request body

4 properties · 1 required · 1 $defs

property	type	description	constraints
file*	string	The audio file to upload.	format: binary
extract_composition_plan	boolean \| enum	Whether to generate and return the composition plan for the uploaded song. Pass a model id (`music_v1`, `music_v2` or `music_v2_5`) to control which composition plan format is returned. Passing `true`/`false` is deprecated; `true` defaults to the `music_v1` pl…	default: false
with_timestamps	boolean	Whether to transcribe the uploaded song and return word-level timestamps. If True, the response will include words_timestamps but will increase the latency.	default: false
with_waveform_visual	boolean	Whether to return the visual waveform of the uploaded song.	default: false

Types

1 $defs

MusicModelIDenum

music_v1 | music_v2 | music_v2_5 · default: "music_v1"

Validate a payload

before you spend tokens

shell

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