Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-06-09

Luma Ray 3.2 Video to Video · Video Edit

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

Edit and transform video with Luma Ray 3.2 Video to Video · Video Edit from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

$0.936 per run at the default inputs. resolution: 540p (default) $0.936, 720p $1.404, 1080p $2.808.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Text prompt describing how to edit the source video.

video_url requiredURL or file—

URL of the source video to edit.

usertext—

Optional opaque identifier for the end user making the request. Used only for abuse attribution; never interpreted by fal.

start_image_urlURL or file—

Optional URL of an image to use as the edited video's first frame — e.g. a restyled version of the source's opening frame to steer the look of the edit. Leave unset to let the model derive the first frame from the source video.

resolutionone of
540p, 720p, 1080p
540p

Resolution of the edited video. Higher resolutions cost more.

durationone of
5s, 10s
5s

Duration of the edited video.

edit_strengthone of
adhere_1, adhere_2, adhere_3, flex_1, flex_2, flex_3, reimagine_1, reimagine_2, reimagine_3
—

How closely the edit preserves the source video. 'adhere_*' stays closest to the source, 'flex_*' is balanced, and 'reimagine_*' diverges most. Leave unset to use Luma's default. Cannot be combined with auto_controls.

auto_controlstrue or falsefalse

Let the model derive the edit conditioning schedule from the source video. Cannot be combined with edit_strength.

hdrtrue or falsefalse

Generate an HDR-encoded MP4. Requires HDR access on the account and a resolution of 720p or 1080p.

exr_exporttrue or falsefalse

Also export an EXR file alongside the MP4. Requires hdr=true and HDR access.

controlsJSON—

Per-signal conditioning controls (pose, depth, normals, trajectory, face) for finer control than edit_strength. Cannot be combined with auto_controls.

keyframeslist—

Multi-keyframe edit guide frames: up to 64 image URLs pinned at the source-frame positions given by keyframe_indexes. Mutually exclusive with start_image_url. Provide keyframes and keyframe_indexes together (same length).

keyframe_indexeslist—

Source-video frame positions 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/video-to-video",
    "input": {
      "prompt": "Restyle the footage as a hand-painted watercolor animation with soft pastel colors.",
      "video_url": "https://storage.googleapis.com/falserverless/example_inputs/birefnet-video-input.mp4"
    }
  }'

Frequently asked questions

How much does Luma Ray 3.2 Video to Video · Video Edit cost?

$0.936 per run at the default inputs. `resolution`: 540p (default) $0.936, 720p $1.404, 1080p $2.808. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Luma Ray 3.2 Video to Video · Video Edit through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "luma/agent/ray/v3.2/video-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Luma Ray 3.2 Video to Video · Video Edit?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Luma Ray 3.2 Video to Video · Video Edit?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.