GET
/v1/schemas/fal/video/fal-ai%2Fcontrolfoley
Accept:
Request body
9 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL of the video to generate synchronized audio for. | |
| negative_prompt | string | Negative text prompt — describe audio characteristics to avoid. | default: "" |
| guidance_scale | number | Classifier-free guidance strength. | 0 ≤ n ≤ 20 · default: 4.5 |
| prompt | string | Optional text prompt describing the desired audio. When combined with the video it provides text-controlled video-to-audio (TC-V2A) generation; leave empty for pure video-to-audio (V2A). | default: "" |
| duration | number | Target audio duration in seconds. Truncated to source video length when shorter. | 1 ≤ n ≤ 30 · default: 8 |
| seed | integer | Random seed for reproducibility. If null, a random seed is used. | nullable |
| reference_audio_url | string | Optional URL to a 2-4 second reference audio clip whose timbre should be transferred to the generated audio (AC-V2A mode). Audio shorter than 2s is zero-padded; longer is truncated. | nullable |
| num_inference_steps | integer | Number of flow-matching ODE steps. | 4 ≤ n ≤ 100 · default: 25 |
| mask_away_clip | boolean | When True, disables the CLIP visual stream (text-driven mode). | default: false |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/controlfoley","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}