Skip to content

fal.ai · Image to video

Luma Ray 3.2

Luma Ray 3.2, image to video, served by fal.ai. The OpenAPI schema for the luma/agent/ray/v3.2/image-to-video queue. Price: 5 s: $0.15 at 540p, $0.30 at 720p, $0.60 at 1080p; 10 s doubles. HDR not offered here. Asynchronous: returns a request_id; poll fal/status and fetch fal/result with model "luma/agent".

From $0.03 / unitfal.aiVideofal/luma-ray-3-2-image-to-videoListed

Activation pending; your agent will see it as unavailable until then.

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool fal/luma-ray-3-2-image-to-video (Luma Ray 3.2, image to video). Call inspect_tool with {"tool_id": "fal/luma-ray-3-2-image-to-video"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "fal/luma-ray-3-2-image-to-video" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
promptstringYesText prompt describing the motion/scene to generate.
resolutionstringNoResolution of the generated video. Higher resolutions cost more. Options: 540p, 720p, 1080p.
exr_exportbooleanNoAlso export an EXR file alongside the MP4. Requires hdr=true and HDR access.
loopbooleanNoGenerate a seamless loop. Only valid for standard-dynamic-range generations without an end frame or keyframes.
keyframesstring[]NoMulti-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).
durationstringNoDuration 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. Options: 5s, 10s.
aspect_ratiostringNoAspect ratio of the generated video. Options: 3:4, 4:3, 1:1, 9:16, 16:9, 21:9.
image_urlstringNoURL 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.
keyframe_indexesinteger[]NoOutput-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.
end_image_urlstringNoOptional 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.

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "fal/luma-ray-3-2-image-to-video",
  "input": {
    "prompt": "a red cube slowly rotating on a white table, soft studio light",
    "image_url": "https://storage.googleapis.com/falserverless/example_outputs/nano-banana-2-t2i-output.png",
    "resolution": "540p",
    "duration": "5s"
  }
}

Price and billing

Price
From $0.03 / unit
Model
Per unit
Detail
The provider’s price, with no markup. Billed for measured usage.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.