GET
/v1/schemas/fal/audio/mirelo-ai/sfx2.0/video-to-audio
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracedf9d8d659ad29aaabe474218810b66902bf73f93bf691a79609f9189121a4652{
"fetchedAt": 1792645225,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | Video to add sound to: an http(s) URL, or a base64 data URI up to 8 MB. | |
| return_speech | boolean | Also return the input's separated speech as its own audio file, in the response's speech. With preserve_speech false the soundtracks are sound effects only and the speech is separated while they generate. With preserve_speech true it is the speech separated fr… | default: false |
| num_samples | integer | Number of variations to generate. Billed per sample. | 1 ≤ n ≤ 4 · default: 2 |
| upload_audio_bitrate_kbps | integer | Bitrate in kbps for an mp3 or aac upload. mp3 is written at exactly this constant rate, one of 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320. aac takes 32 to 256 as a target the encoder may undershoot on mono or sparse audio. Unset keeps the default: mp3 at LAME V0 VBR, aac at a 256 kbps target. Refused with a lossless upload_audio_format. | 32 ≤ n ≤ 320 · nullable |
| duration | number | Seconds of sound to generate, from 1 s to 600 s, clamped to the video's length. Over 10 s generates in 10 s windows. A video shorter than 1 s answers 400. | 1 ≤ n ≤ 600 · default: 10 |
| text_prompt | string | Optional text guiding the soundtrack. Name sounds the picture does not show, such as off-screen sounds or an ambience bed, to have them worked into it. | length ≤ 2000 · nullable |
| negative_prompt | string | Sounds to keep out of the result, as a short comma-separated list. | length ≤ 1000 · nullable |
| preserve_speech | boolean | Keep the speech in the input's audio and generate the rest of the soundtrack around it. False generates sound effects only and suppresses speech. | default: true |
| upload_audio_format | enum | Audio format of each file | wav | mp3 | aac | flac · default: "wav" |
| seed | integer | Seed for generation. -1 or None for random. | -1 ≤ n ≤ 18446744073709552000 · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"mirelo-ai/sfx2.0/video-to-audio","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}