fal.ai·Video generation

Luma Ray 2

/fal-ai/luma-dream-machine/ray-2async$0.75 / 5 seconds of video

Ray2 is a large-scale video generative model capable of creating realistic visuals with natural, coherent motion. Returns hosted file URLs (download promptly; fal keeps them for a limited time). Billed per 5 seconds of video.

Charged per 5 seconds of video produced; a call that produces nothing is charged one unit.

Input

loopboolean
Whether the video should loop (end of video is blended with the beginning) (default false)
durationstring
The duration of the generated video (9s costs 2x more) (default "5s")
5s, 9s
resolutionstring
The resolution of the generated video (720p costs 2x more, 1080p costs 4x more) (default "540p")
540p, 720p, 1080p
promptstringrequired
prompt
aspect_ratiostring
The aspect ratio of the generated video (default "16:9")
16:9, 9:16, 4:3, 3:4, 21:9, 9:21

Field	Type	Required	Description
loop	boolean	—	Whether the video should loop (end of video is blended with the beginning) (default false)
duration	string (5s, 9s)	—	The duration of the generated video (9s costs 2x more) (default "5s")
resolution	string (540p, 720p, 1080p)	—	The resolution of the generated video (720p costs 2x more, 1080p costs 4x more) (default "540p")
prompt	string	yes	prompt
aspect_ratio	string (16:9, 9:16, 4:3, 3:4, 21:9, 9:21)	—	The aspect ratio of the generated video (default "16:9")

Run it

curl -s https://sooma.dev/v1/run \ -H "Authorization: Bearer $SOOMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"fal","endpoint":"/fal-ai/luma-dream-machine/ray-2","input":{"prompt":"A cinematic photo of a lighthouse at dawn, soft light"}}'

Or ask your agent: it will call inspect for this schema and run it over MCP.