API Reference

Generations

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get a generation

generations.get(strgeneration_id) -> Generation

GET/generations/{generation_id}

Poll for generation status and output. On completion, the response includes presigned URLs to download the generated images.

ParametersExpand Collapse

generation_id: str

formatuuid

ReturnsExpand 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

Get a generation

Python

HTTP

TypeScript

Python

Go

CLI Tool

import os
from luma_agents import Luma

client = Luma(
    auth_token=os.environ.get("LUMA_AGENTS_API_KEY"),  # This is the default and can be omitted
)
generation = client.generations.get(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(generation.id)

200 example

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "created_at": "created_at",
  "model": "uni-1",
  "state": "queued",
  "type": "image",
  "failure_code": "content_moderated",
  "failure_reason": "failure_reason",
  "output": [
    {
      "type": "type",
      "url": "https://example.com"
    }
  ]
}

Returns Examples

200 example

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "created_at": "created_at",
  "model": "uni-1",
  "state": "queued",
  "type": "image",
  "failure_code": "content_moderated",
  "failure_reason": "failure_reason",
  "output": [
    {
      "type": "type",
      "url": "https://example.com"
    }
  ]
}