Question 1

What is the Luma Agents API?

Accepted Answer

A REST API for generating and editing images and videos with Luma’s models — uni‑1 and uni‑1‑max for images, Ray 3.2 for video. A single endpoint, POST /v1/generations, handles image generation, image editing, video generation/extension, video editing, and video reframing.

Question 2

What is uni‑1?

Accepted Answer

Uni‑1 is Luma’s unified image generation and editing model. It handles text‑to‑image and image‑to‑image through the same endpoint, with support for text rendering, spatial reasoning, multi‑panel output, and style transfer.

Question 3

What is uni‑1‑max?

Accepted Answer

Uni‑1‑max produces higher‑quality output than uni‑1. It uses the same wire format and parameters; the only difference is the higher per‑image cost.

Question 4

When should I use uni‑1‑max vs uni‑1?

Accepted Answer

Use uni‑1 for general generation and editing tasks at lower cost. Use uni‑1‑max when higher quality is required and the cost increase is justified, such as final hero images or ad creative.

Question 5

What is Ray 3.2?

Accepted Answer

Ray 3.2 is Luma’s video model on the Agents API. It handles text‑to‑video and image‑to‑video, single‑keyframe video extend, video editing, and aspect‑ratio reframing.

Question 6

How do I get an API key?

Accepted Answer

Create an account at platform.lumalabs.ai, generate a key from the developer dashboard, and set it as the LUMA_AGENTS_API_KEY environment variable.

Question 7

Is the API synchronous or asynchronous?

Accepted Answer

The API is asynchronous. POST /v1/generations returns a job ID and state; you poll GET /v1/generations/{id} until the state reaches completed or failed.

Luma

Free boost for 100 visitors

Products

Services

Can AI read this site?