Luma modelsimage generation api

luma/photon-1/edit

Name: Luma Photon Edit
Author: Luma

Photon 1 Edit is Luma's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input

Prompt(string)

Instruction for modifying the image

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/edit

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	Instruction for modifying the image · 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/edit",
  "image": "https://static.sandbase.ai/examples/luma/photon-1/edit/input_image_0.png",
  "prompt": "Make the image look like a painting"
}'

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

← Back to Luma Photon Edit

API README

Luma Photon Edit

Luma Photon Edit is a Luma route built for prompt-guided image editing. It turns one or more source images and a precise change request into a revised image that follows the edit while retaining intended structure, 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 Edit: dedicated guided image editing. This exact route centers on guided image editing; 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.
guided image editing 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 prompt-guided image editing and already have one or more source images and a precise change request.
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 revised image that follows the edit while retaining intended structure.
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 prompt-guided image editing, 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": "Make the image look like a painting",
  "image": "https://static.sandbase.ai/examples/luma/photon-1/edit/input_image_0.png",
  "aspect_ratio": "21:9"
}

Technical Specs

Specification	Value
Model ID	`luma/photon-1/edit`
Workflow	Prompt-guided image editing
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`