v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Retrieve a Seedream image generation task

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

get/v1/images/generations/{task_id}

Path parameters

task_idstring required

Task ID returned in data.task_id by the async create request.

Response

Current Seedream image generation task state.

codestring required

Request status code. Successful task lookups return success.

messagestring

Optional status message.

Example response

{
  "code": "success",
  "data": {
    "task_id": "<task_id>",
    "status": "success",
    "data": [
      {
        "url": "<image-url>",
        "b64_json": "<base64-image-data>",
        "revised_prompt": "<revised-prompt>"
      }
    ]
  }
}