GET
/v1/schemas/fal/video/fal-ai/magi-distilled/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracee580c080afccc7a26d1dc06c98cfd7515a4dae9875ebd226b9226c63c70a1fe3{
"fetchedAt": 1786770058,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | URL of the input image to represent the first frame of the video. If the input image does not match the chosen aspect ratio, it is resized and center cropped. | |
| prompt* | string | The text prompt to guide video generation. | |
| resolution | enum | Resolution of the generated video (480p or 720p). 480p is 0.5 billing units, and 720p is 1 billing unit. | 480p | 720p · default: "720p" |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked. | default: true |
| aspect_ratio | enum | Aspect ratio of the generated video. If 'auto', the aspect ratio will be determined automatically based on the input image. | auto | 16:9 | 9:16 | 1:1 · default: "auto" |
| num_frames | integer | Number of frames to generate. Must be between 96 and 192 (inclusive). Each additional 24 frames beyond 96 incurs an additional billing unit. | 96 ≤ n ≤ 192 · nullable |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| num_inference_steps | enum | Number of inference steps for sampling. Higher values give better quality but take longer. | 4 | 8 | 16 | 32 · default: 16 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/magi-distilled/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}