Skip to main content
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

ParameterTypeRequiredDescriptionDefault
modelstringYesMust be luma-ray-3-2-reframe-
promptstringYesContent to paint into the newly exposed canvas area, 1–6000 characters-
aspect_ratioenumYesTarget ratio: 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 — must differ from the source’s ratio16:9
resolutionenumNoOutput resolution: 540p, 720p, 1080p720p
source_generation_idstringYes*Id of a prior completed video owned by the same API key, 30s or shorter. *Required unless source_data is provided instead""
source_datastringNoInline base64 source video (advanced), alternative to source_generation_id, 30s or shorter""
source_media_typestringNoMIME 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.
Quality540p720p1080p
SDR$0.15$0.30$1.20
HDR and EXR are not available on reframe.