GET

/v1/schemas/elevenlabs/audio/v1/music/video-to-music

Accept:

kind inputactivity audiohash 4dc7e98c…extracted Oct 15, 2026version currentsource upstream spec ↗

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

Request body

8 properties · 1 required · 1 $defs

property	type	description	constraints
videos*	string[]	One or more video files sent via FormData array (multipart/form-data). They will be combined into one codec in order. A maximum of 10 videos is allowed, where the total size of the combined video is limited to 200MB. In total, the video can be up to 600 second…	items ≥ 1 · items ≤ 10
description	string	Optional text description of the music you want. A maximum of 4100 characters is allowed.	length ≥ 1 · length ≤ 4100 · nullable
tags	string[]	Optional list of style tags (e.g. ['upbeat', 'cinematic']). A maximum of 10 tags is allowed.	items ≥ 0 · items ≤ 10 · default: []
model_id	enum	The model to use for the generation.	music_v1 \| music_v2 \| music_v2_5 · default: "music_v1"
add_sfx	boolean	When true, incorporate SFX cues from the video.	default: false
separate_tracks	boolean	When true, return a ZIP with separate music and SFX audio tracks instead of a single mixed file. Use this for more flexibility to layer the tracks.	default: false
use_audio_as_reference	boolean	When true, analyze the video's audio track and use its genres, BPM, instrumentation, mood, and arc as reference characteristics for music generation.	default: false
sign_with_c2pa	boolean	Whether to sign the generated song with C2PA. Applicable only for mp3 files.	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/video-to-music","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}