falImage to videoComing soon

luma/agent/ray/v3.2/image-to-video

Name: luma/agent/ray/v3.2/image-to-video
Brand: fal

luma/agent/ray/v3.2/image-to-video is an image to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Priced by usage

Pricing

duration: 5s (default) $0.195, 10s $0.39, otherwise $0.39 per run. The final charge comes from usage.

Limits

Runs: In the background
Returns: video
Longest queue wait: 3600s
Run deadline: 3600s
Largest inline input: 1024 KB
Largest input file: 500 MB
Largest output: 4768 MB
Outputs per run: 16

Input

Field	Kind	Default	Description
`prompt` required	text	—	Text prompt describing the motion/scene to generate.
`image_url`	URL or file	—	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.
`end_image_url`	URL or file	—	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.
`aspect_ratio`	one of 3:4, 4:3, 1:1, 9:16, 16:9, 21:9	16:9	Aspect ratio of the generated video.
`resolution`	one of 540p, 720p, 1080p	540p	Resolution of the generated video. Higher resolutions cost more.
`duration`	one of 5s, 10s	5s	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.
`loop`	true or false	false	Generate a seamless loop. Only valid for standard-dynamic-range generations without an end frame or keyframes.
`hdr`	true or false	false	Generate an HDR-encoded MP4. Requires HDR access on the account and a resolution of 720p or 1080p; not supported with loop.
`exr_export`	true or false	false	Also export an EXR file alongside the MP4. Requires hdr=true and HDR access.
`keyframes`	list	—	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).
`keyframe_indexes`	list	—	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.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "luma/agent/ray/v3.2/image-to-video",
    "input": {
      "prompt": "Low-angle shot of a majestic tiger prowling through a snowy landscape, leaving paw prints on the white blanket."
    }
  }'