> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# luma-ray-3-2-reframe

> API usage guide for luma-ray-3-2-reframe.

{/* source_model_id: luma-ray-3-2-reframe */}

{/* source_updated_at: 1781738923 */}

**Model ID**

```bash theme={null}
luma-ray-3-2-reframe
```

**Calling method:** async

# Luma Ray 3.2 — Reframe

## Overview

`luma-ray-3-2-reframe` uses Luma's `ray-3.2` model to AI-outpaint a prior completed video to a **different aspect ratio** via the Luma Agents API. The source's content is preserved frame-for-frame; the model fills the expanded canvas around it — same content, new shape. This is distinct from **Generate** (new content from scratch) and **Edit** (restyle existing content). Reframe is **standard dynamic range only** and the output follows the source video's duration.

Reference the source video two ways:

* **By generation id** (recommended): `source_generation_id`, the id of a prior completed video generation owned by the same API key. Create one with **Luma Ray 3.2 — Generate**.
* **Inline (advanced)**: base64 `source_data` plus `source_media_type`. The source must be 30 seconds or shorter. Direct source-URL ingestion is not yet supported.

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Submit

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-ray-3-2-reframe",
    "payload": {
      "prompt": "extend the scene to cinematic widescreen",
      "aspect_ratio": "21:9",
      "source_generation_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "resolution": "720p"
    }
  }'
```

## Request Parameters

| Parameter              | Type   | Required | Description                                                                                                                  | Default |
| ---------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------- | ------- |
| `model`                | string | Yes      | Must be `luma-ray-3-2-reframe`                                                                                               | -       |
| `prompt`               | string | Yes      | Content to paint into the newly exposed canvas area, 1–6000 characters                                                       | -       |
| `aspect_ratio`         | enum   | Yes      | Target ratio: `9:16`, `3:4`, `1:1`, `4:3`, `16:9`, `21:9` — must differ from the source's ratio                              | `16:9`  |
| `resolution`           | enum   | No       | Output resolution: `540p`, `720p`, `1080p`                                                                                   | `720p`  |
| `source_generation_id` | string | Yes\*    | Id of a prior completed video owned by the same API key, 30s or shorter. \*Required unless `source_data` is provided instead | ""      |
| `source_data`          | string | No       | Inline base64 source video (advanced), alternative to `source_generation_id`, 30s or shorter                                 | ""      |
| `source_media_type`    | string | No       | MIME type for `source_data`, e.g. `video/mp4`                                                                                | ""      |

## Status

Video generation is asynchronous and takes longer than image generation. The submit returns `status: processing` with a `request_id`; poll until terminal:

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

`status` is `queued` → `processing` → `success` or `failed`.

## Response

```json theme={null}
{
  "request_id": "cd5b59d5-1b3f-4fd5-9899-15ecea1f28ba",
  "model": "luma-ray-3-2-reframe",
  "status": "success",
  "outcome": {
    "video_url": "https://storage.googleapis.com/.../output.mp4",
    "generation_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "thumbnail_image_url": "https://storage.googleapis.com/.../thumbnail.jpg"
  }
}
```

Use `generation_id` to chain a follow-up edit, extend, or reframe.

## Constraints

* `aspect_ratio` is required and must differ from the source's ratio — reframing to the same ratio has no effect.
* Standard dynamic range only: `hdr`, `exr_export`, `loop`, and keyframes (`start_frame`/`end_frame`) are not applicable to reframe.
* Source video must be 30 seconds or shorter. Direct source-URL ingestion is not yet supported.

## Pricing

Billed at the **create-tier per 5-second block, standard dynamic range only**. The output duration follows the source video and is billed in 5-second blocks, rounded up.

| Quality | 540p   | 720p   | 1080p  |
| ------- | ------ | ------ | ------ |
| SDR     | \$0.15 | \$0.30 | \$1.20 |

HDR and EXR are not available on reframe.