Luma Ray 3.2 Reframe
luma/agent/ray/v3.2/reframeEdit and transform video with Luma Ray 3.2 Reframe from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
resolution: 540p (default) $0.078, 720p $0.156, 1080p $0.468 per second.
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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Text prompt describing the content to paint into the newly exposed canvas area when reframing to the target aspect ratio. |
video_url required | URL or file | — | URL of the source video to reframe (must be 10 seconds or less). |
aspect_ratio required | one of 3:4, 4:3, 1:1, 9:16, 16:9, 21:9 | — | Target aspect ratio for the reframed video. |
resolution | one of 540p, 720p, 1080p | 540p | Resolution of the reframed video. Higher resolutions cost more. |
duration | one of 5s, 10s | — | Duration of the reframed video. Defaults to matching the source video's duration; set explicitly to 5s or 10s to override. |
source_position | JSON | — | Optional normalized source rectangle controlling where the source video sits in the output canvas. |
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/reframe",
"input": {
"prompt": "Extend the scene into cinematic widescreen with matching lighting and background detail.",
"video_url": "https://storage.googleapis.com/falserverless/example_inputs/birefnet-video-input.mp4",
"aspect_ratio": "3:4"
}
}'Frequently asked questions
How much does Luma Ray 3.2 Reframe cost?
`resolution`: 540p (default) $0.078, 720p $0.156, 1080p $0.468 per second. 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 Reframe through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "luma/agent/ray/v3.2/reframe"` 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 Reframe?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Luma Ray 3.2 Reframe?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.