GET

/v1/schemas/fal/video/sonilo/v1.1/video-to-video-sound-effects

Accept:

kind inputactivity videohash aba1f26e…extracted Oct 3, 2026version currentsource upstream spec ↗

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

Request body

5 properties · 1 required · 1 $defs

property	type	description	constraints
video_url*	string	The video to add sound to (public URL, or upload a file). The generated audio matches the video's length.
prompt	string	Optional. Describe the kind of sound you want; it steers the generated audio for every scene. Leave empty to caption the video automatically.	nullable
segments	SfxSegment[]	Optional. Split the video into time ranges, each with its own sound description. Leave empty to split into scenes automatically.	nullable
audio_format	enum	Format of the returned audio file: aac (default), mp3, wav, or flac. (The video with sound is always AAC.)	wav \| mp3 \| aac \| flac · default: "aac"
keep_speech_vocal	boolean	Keep the original video's speech/vocals. When on, the source audio is separated (music source separation) and the isolated vocals are kept as recorded, with the generated sound mixed in at a level matched to the voice; the rest of the original soundtrack (musi…	default: false

Types

1 $defs

SfxSegmentobject

start	number	Segment start time in seconds (from video start). The FIRST segment's start must be 0.	n ≥ 0 · default: 0
end	number	Segment end time in seconds. Must equal the next segment's start (contiguous; no gaps/overlaps); the last segment's end must be <= the video duration.	n ≥ 0 · default: 0
prompt	string	SFX / foley description for this segment.	default: ""

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"sonilo/v1.1/video-to-video-sound-effects","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}