Model ID

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

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

{
  "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.

luma-ray-3-2-generate Minimax-Hailuo-02

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

luma-ray-3-2-reframe

Luma Ray 3.2 — Reframe

Overview

Authentication

Submit

Request Parameters

Status

Response

Constraints

Pricing

​Luma Ray 3.2 — Reframe

​Overview

​Authentication

​Submit

​Request Parameters

​Status

​Response

​Constraints

​Pricing

Luma Ray 3.2 — Reframe

Overview

Authentication

Submit

Request Parameters

Status

Response

Constraints

Pricing