# Luma Ray 3.2 Reframe

Edit 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.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `luma/agent/ray/v3.2/reframe`
- Page: https://spiral.ai/tools/fal/luma/agent/ray/v3.2/reframe

## Pricing

Up to $4.68 per run at the default inputs for 60 seconds of input. `resolution`: 540p (default) $4.68, 720p $9.36, 1080p $28.08.

## Limits

- 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 | Allowed | 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. |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=luma%2Fagent%2Fray%2Fv3.2%2Freframe

## Common questions

### Luma Ray 3.2 Reframe

**How much does Luma Ray 3.2 Reframe cost?**

Up to $4.68 per run at the default inputs for 60 seconds of input. `resolution`: 540p (default) $4.68, 720p $9.36, 1080p $28.08. 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.

