Skip to content
Luma Agents
lumalabs.ai
API Reference

Generations

Create a generation
generations.create(GenerationCreateParams**kwargs) -> Generation
POST/generations
Get a generation
generations.get(strgeneration_id) -> Generation
GET/generations/{generation_id}
ModelsExpand Collapse
class Generation: …

Generation status and output

id: str

Generation identifier

formatuuid
created_at: str

Creation timestamp

model: Model

Model used

One of the following:
"uni-1"
"uni-1-max"
state: Literal["queued", "processing", "completed", "failed"]

Current state of the generation

One of the following:
"queued"
"processing"
"completed"
"failed"
type: Literal["image", "image_edit"]

The kind of generation to perform

One of the following:
"image"
"image_edit"
failure_code: Optional[GenerationFailureCode]

Machine-readable failure code for programmatic handling

One of the following:
"content_moderated"
"generation_failed"
"budget_exhausted"
"output_not_found"
"image_too_large"
"unsupported_format"
"corrupt_input"
"invalid_request"
"rate_limited"
failure_reason: Optional[str]

Human-readable failure description

output: Optional[List[GenerationOutput]]

Generated outputs (populated on completion)

type: str

Media type (e.g. image)

url: str

Presigned URL (1hr expiry)

formaturi
Literal["content_moderated", "generation_failed", "budget_exhausted", 6 more]

Machine-readable failure code for programmatic handling

One of the following:
"content_moderated"
"generation_failed"
"budget_exhausted"
"output_not_found"
"image_too_large"
"unsupported_format"
"corrupt_input"
"invalid_request"
"rate_limited"
class GenerationOutput: …

A single generated output

type: str

Media type (e.g. image)

url: str

Presigned URL (1hr expiry)

formaturi
Literal["uni-1", "uni-1-max"]

Model identifier. uni-1 is the default tier; uni-1-max produces higher-quality output than uni-1 at a higher per-image price. Both models are available to all accounts — see Pricing for per-image rates.

One of the following:
"uni-1"
"uni-1-max"