GET
/v1/schemas/fal/video/fal-ai%2Fbernini-r%2Freference-to-video
Accept:
Request body
11 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| reference_image_urls* | string[] | Reference subject image(s); up to 5. | items ≥ 1 · items ≤ 5 |
| prompt* | string | Text prompt or editing instruction. | |
| aspect_ratio | enum | Output aspect ratio. | 16:9 | 9:16 | 1:1 · default: "16:9" |
| enable_prompt_expansion | boolean | Rewrite the prompt with an LLM before generation. The model is tuned on enhanced prompts; off by default. | default: false |
| acceleration | enum | Acceleration level. 'regular' enables MagCache step-skipping for faster generation at a small quality cost; 'none' (default) runs the full denoising schedule. | none | regular · default: "none" |
| num_inference_steps | integer | Number of denoising steps. | 1 ≤ n ≤ 50 · default: 30 |
| frames_per_second | integer | Output frames per second. | 4 ≤ n ≤ 30 · default: 16 |
| negative_prompt | string | Negative prompt. Defaults to the standard Wan2.2 negative prompt. | nullable |
| num_frames | integer | Number of frames. Snapped internally to 4k+1. | 5 ≤ n ≤ 121 · default: 81 |
| seed | integer | Seed for reproducibility. Random when omitted. | nullable |
| max_image_size | integer | Long-edge size (px). Sets the output size for generation tasks and caps source/reference media for editing tasks. | 256 ≤ n ≤ 1280 · default: 848 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/bernini-r/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}