GET
/v1/schemas/fal/video/luma/agent/ray/v3.2/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace42eb85db15c0abe52ab3f6ea3b29ff5077a6c03348732600fa6b9a0ad1a6bd06{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text prompt describing the motion/scene to generate. | length ≥ 1 · length ≤ 6000 |
| image_url | string | URL of the image used as the first frame of the video. Provide either image_url (optionally with end_image_url) or keyframes — the two anchoring modes are mutually exclusive. | length ≥ 1 · nullable |
| hdr | boolean | Generate an HDR-encoded MP4. Requires HDR access on the account and a resolution of 720p or 1080p; not supported with loop. | default: false |
| loop | boolean | Generate a seamless loop. Only valid for standard-dynamic-range generations without an end frame or keyframes. | default: false |
| exr_export | boolean | Also export an EXR file alongside the MP4. Requires hdr=true and HDR access. | default: false |
| end_image_url | string | Optional URL of an image used as the last frame. When set, the model interpolates between image_url and end_image_url. Cannot be combined with keyframes. | nullable |
| duration | enum | Duration of the generated video. 10s requires multi-keyframe input (keyframes / keyframe_indexes); it is not supported with a single image_url / end_image_url anchor. | 5s | 10s · default: "5s" |
| keyframe_indexes | integer[] | Output-frame positions (duration x 24fps: 5s -> 0-120, 10s -> 0-240) where each keyframes[i] is anchored. Non-negative, unique, and the same length as keyframes. | items ≥ 1 · items ≤ 64 · nullable |
| aspect_ratio | enum | Aspect ratio of the generated video. | 3:4 | 4:3 | 1:1 | 9:16 | 16:9 | 21:9 · default: "16:9" |
| resolution | enum | Resolution of the generated video. Higher resolutions cost more. | 540p | 720p | 1080p · default: "540p" |
| keyframes | string[] | Multi-keyframe image-to-video guide frames: 1-64 image URLs pinned at the positions given by keyframe_indexes. Mutually exclusive with image_url, end_image_url, and loop; unlocks 10s and HDR. Provide keyframes and keyframe_indexes together (same length). | items ≥ 1 · items ≤ 64 · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"luma/agent/ray/v3.2/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}