---
title: "Retrieve a Seedream image generation task"
method: GET
path: "/v1/images/generations/{task_id}"
---

# Retrieve a Seedream image generation task

`GET /v1/images/generations/{task_id}`

Poll an async Seedream image generation task by task ID. Use the `task_id` returned by an async `POST /v1/images/generations` request.

## Path parameters

- `task_id` string, required

## Response `200`

Current Seedream image generation task state.

- object
  - `code` string, required — Request status code. Successful task lookups return `success`.
  - `message` string — Optional status message.
  - `data` object, required
    - `task_id` string, required — Task ID for this Seedream image generation job.
    - `status` 'pending' | 'success' | 'failure', required — Task state. Poll while the value is `pending`; read `data[]` when the value is `success`.
    - `data` object[], required — Generated image data. The array is empty until the task succeeds.
      - `url` string — Temporary image URL when URL output is available.
      - `b64_json` string — Base64-encoded image payload when inline output is available.
      - `revised_prompt` string — Provider-rewritten prompt, when available.
    - `fail_reason` string — Failure reason when the task status is `failure`.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)