GET

/v1/schemas/fal/video/fal-ai/luma-dream-machine/ray-2/image-to-video

Accept:

kind inputactivity videohash 53846695…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `43ac333da7f09e64c71ca6b1b8a961c8309b92a986b661e192bede604cfc4c90` { "fetchedAt": 1783329487, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 1 required · 0 $defs

property	type	description	constraints
prompt*	string		length ≥ 3 · length ≤ 5000
resolution	enum	The resolution of the generated video (720p costs 2x more, 1080p costs 4x more)	540p \| 720p \| 1080p · default: "540p"
image_url	string	Initial image to start the video from. Can be used together with end_image_url.	nullable
duration	enum	The duration of the generated video	5s \| 9s · default: "5s"
loop	boolean	Whether the video should loop (end of video is blended with the beginning)	default: false
aspect_ratio	enum	The aspect ratio of the generated video	16:9 \| 9:16 \| 4:3 \| 3:4 \| 21:9 \| 9:21 · default: "16:9"
end_image_url	string	Final image to end the video with. Can be used together with image_url.	nullable

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/luma-dream-machine/ray-2/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}