## Get a generation

**get** `/generations/{generation_id}`

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

### Path Parameters

- `generation_id: string`

### Returns

- `Generation = object { id, created_at, model, 5 more }`

  Generation status and output

  - `id: string`

    Generation identifier

  - `created_at: string`

    Creation timestamp

  - `model: Model`

    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 GenerationFailureCode`

    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`

    Generated outputs (populated on completion)

    - `type: string`

      Media type (e.g. image)

    - `url: string`

      Presigned URL (1hr expiry)

### Example

```http
curl https://agents.lumalabs.ai/v1/generations/$GENERATION_ID \
    -H "Authorization: Bearer $LUMA_AGENTS_API_KEY"
```

#### Response

```json
{
  "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"
    }
  ]
}
```