API Reference

Generations

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get a generation

$ luma-agents-cli generations get

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: string

Generation UUID returned by POST /generations

ReturnsExpand Collapse

generation: object { id, created_at, model, 5 more }

Generation status and output

id: string

Generation identifier

created_at: string

Creation timestamp

model: "uni-1" or "uni-1-max"

Model used

"uni-1"

"uni-1-max"

state: "queued" or "processing" or "completed" or "failed"

Current state of the generation

"queued"

"processing"

"completed"

"failed"

type: "image" or "image_edit"

The kind of generation to perform

"image"

"image_edit"

failure_code: optional "content_moderated" or "generation_failed" or "budget_exhausted" or 6 more

Machine-readable failure code for programmatic handling

"content_moderated"

"generation_failed"

"budget_exhausted"

"output_not_found"

"image_too_large"

"unsupported_format"

"corrupt_input"

"invalid_request"

"rate_limited"

failure_reason: optional string

Human-readable failure description

output: optional array of GenerationOutput { type, url }

Generated outputs (populated on completion)

type: string

Media type (e.g. image)

url: string

Presigned URL (1hr expiry)

Get a generation

CLI Tool

HTTP

TypeScript

Python

Go

CLI Tool

luma-agents-cli generations get \
  --auth-token 'My Auth Token' \
  --generation-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e

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"
    }
  ]
}