---
title: "Get Image Generation"
method: GET
path: "/v1/flows/image/{generation_id}"
tags: ["Flows", "Image"]
---

# Get Image Generation

`GET /v1/flows/image/{generation_id}`

Retrieve the status of an image generation, and retrieve its output URL once completed.

## Path parameters

- `generation_id` string, required

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- union
  - MediaGenerationInProgressResponse — A media generation that has not finished yet.
    - `id` string, required — The unique identifier of the generation.
    - `status` 'pending' | 'generating', required — The lifecycle status of the generation. It ends at `completed` or `failed`.
  - MediaGenerationCompletedResponse — A completed media generation and its output.
    - `id` string, required — The unique identifier of the generation.
    - `status` 'completed', required — The lifecycle status of the generation.
    - `content_url` string, required — A signed URL to download the generated media from. It expires about an hour after this response is returned; fetch the generation again for a fresh URL.
    - `content_mime_type` string, required — The MIME type of the generated media.
  - MediaGenerationFailedResponse — A failed media generation and why it failed.
    - `id` string, required — The unique identifier of the generation.
    - `status` 'failed', required — The lifecycle status of the generation.
    - `failure_reason` 'timeout' | 'model_error' | 'moderated' | 'invalid_parameters' | 'dependency_failed' | 'charging_failed' | 'internal_error', required — The category of failure.
    - `error_message` string, required — A human-readable description of the failure. Failed generations are not charged.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/acb0175c0525/schema)