GET
/v1/schemas/fal/video/fal-ai/cosmos-predict-2.5/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracea4d14c7d373cf4fc4de70ac88c5c20d793efe714b2733d234663a722086cf753{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
11 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | URL of the input image to use as first frame. | |
| prompt* | string | The text prompt describing the video to generate. | |
| num_inference_steps | integer | Number of denoising steps. More steps yield higher quality but take longer. | 1 ≤ n ≤ 50 · default: 35 |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. | default: false |
| negative_prompt | string | A negative prompt to guide generation away from undesired content. | default: "The video captures a series of … |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| guidance_scale | number | Classifier-free guidance scale. Higher values increase prompt adherence. | 1 ≤ n ≤ 20 · default: 7 |
| video_output_type | enum | The format of the output video. | X264 (.mp4) | VP9 (.webm) | PRORES4444 (.mov) | GIF (.gif) · default: "X264 (.mp4)" |
| num_frames | integer | Number of frames to generate. Must be between 9 and 93. | 9 ≤ n ≤ 93 · default: 93 |
| seed | integer | Random seed for reproducible generation. | nullable |
| video_quality | enum | The quality of the output video. | low | medium | high | maximum · default: "high" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/cosmos-predict-2.5/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}