Luma modelsimage generation api

luma/photon-1/reframe

Name: Luma Photon Reframe
Author: Luma

Photon 1 Reframe by Luma - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Input

Prompt(string)

Optional prompt for reframing

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of the input image to reframe

This field is required.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDluma/photon-1/reframe

Input Schema

3 parameters · 2 required · 1 optional

Parameter	Type	Required	Description
`image`	string	Required	URL of the input image to reframe
`prompt`	string	Required	Optional prompt for reframing · Min length: 3 · Max length: 5000
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "luma/photon-1/reframe",
  "image": "https://static.sandbase.ai/examples/luma/photon-1/reframe/input_image_0.png",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Luma Photon Reframe

API README

Luma Photon Reframe

Luma Photon Reframe is a Luma route built for visual reframing. It turns an existing visual asset and target canvas into a recomposed result for a different aspect ratio, giving creators a focused endpoint instead of forcing one generic workflow across materially different production tasks. The route belongs to a family known for natural motion, strong prompt interpretation, and cinematic camera behavior, so it is best evaluated as a creative system for intentional shots and assets rather than as a one-click novelty generator.

Use this endpoint when the input contract and deliverable match that job exactly. Its documented controls include aspect_ratio choices (21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16). Together, these controls help teams plan predictable iterations, compare outputs under stable settings, and connect generation to concept films, campaign visuals, and rapid shot exploration without hiding the operational choices that shape the result.

Highlights

Luma Photon Reframe: dedicated canvas reframing. This exact route centers on canvas reframing; it uses prompt, image to separate its job from neighboring endpoints in the same family.
image control. URL of the input image to reframe; this setting provides a concrete lever for route-specific output planning.
aspect_ratio control. options 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16; use it to build controlled comparisons without changing the rest of the request.
canvas reframing contract control. This route keeps the documented source-to-output relationship explicit; together with the other documented fields, it supports repeatable review of this model path.

Pricing

Configuration	Price
Standard request	`$0.019000`

When to Use

Scenario	Why this model fits
Create the exact route output	Choose it when you need visual reframing and already have an existing visual asset and target canvas.
Develop controlled variations	Keep the main brief fixed while changing one documented setting at a time to compare motion, framing, quality, or asset behavior.
Build repeatable batches	Use a consistent request shape for catalog, campaign, storyboard, game-asset, or social-content production.
Preserve source intent	Prefer this route when the supplied reference material must remain the foundation of a recomposed result for a different aspect ratio.
Connect a media pipeline	Use asynchronous results in an automated review, approval, post-production, or asset-management workflow.

Prompt Guide

Start with the desired result, then describe the source relationship, subject action, composition or camera behavior, lighting, style, and timing. For visual reframing, state what must remain stable as clearly as what should change. Use only fields exposed by the schema; the example below is structurally valid for this route.

{
  "prompt": "A cinematic product shot with deliberate camera movement, natural light, and clearly described timing.",
  "image": "https://static.sandbase.ai/examples/luma/photon-1/reframe/input_image_0.png",
  "aspect_ratio": "21:9"
}

Technical Specs

Specification	Value
Model ID	`luma/photon-1/reframe`
Workflow	Visual reframing
Required inputs	`prompt`, `image`
`image`	`string`
`prompt`	`string`
`aspect_ratio`	`string`; options: `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`