> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 获取 Seedream 图像任务
> 使用 CometAPI GET /v1/images/generations/{task_id} 轮询异步 Seedream 图像生成任务，并获取最终图像数据。
在你使用 `POST /v1/images/generations` 并设置 `async: true` 创建 Seedream 图像后，使用此端点。创建请求会返回 `data.task_id`，当任务成功时，此端点会返回任务状态以及最终图像数据。
## 轮询 Seedream 图像任务
发送带有 `async: true` 的 `POST /v1/images/generations`，然后保存 `data.task_id`。
使用已保存的任务 ID 调用此端点，直到 `data.status` 为 `success` 或 `failure`。
当 `data.status` 为 `success` 时，读取 `data.data` 中的第一项。Seedream 异步结果可能包含 `url`、`b64_json` 和 `revised_prompt`。
## 状态值
* `pending`：任务正在排队或生成中。
* `success`：任务已完成，且 `data.data` 包含生成的图像数据。
* `failure`：任务失败。返回时请检查 `data.fail_reason`。
## OpenAPI
````yaml api/openapi/image/seededit-seedream/get-bytedance-image-generation-task.openapi.json GET /v1/images/generations/{task_id}
openapi: 3.1.0
info:
title: Seedream image generation task API
version: 1.0.0
description: >-
Retrieve an async Seedream image generation task created by `POST
/v1/images/generations` with `async: true`.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/v1/images/generations/{task_id}:
get:
summary: Retrieve a Seedream image generation task
description: >-
Poll an async Seedream image generation task by task ID. Use the
`task_id` returned by an async `POST /v1/images/generations` request.
operationId: retrieve_seedream_image_generation_task
parameters:
- name: task_id
in: path
required: true
description: Task ID returned in `data.task_id` by the async create request.
schema:
type: string
example:
responses:
'200':
description: Current Seedream image generation task state.
content:
application/json:
schema:
type: object
required:
- code
- data
properties:
code:
type: string
description: >-
Request status code. Successful task lookups return
`success`.
example: success
message:
type: string
description: Optional status message.
data:
type: object
required:
- task_id
- status
- data
properties:
task_id:
type: string
description: Task ID for this Seedream image generation job.
status:
type: string
description: >-
Task state. Poll while the value is `pending`; read
`data[]` when the value is `success`.
enum:
- pending
- success
- failure
data:
type: array
description: >-
Generated image data. The array is empty until the
task succeeds.
items:
type: object
properties:
url:
type: string
description: >-
Temporary image URL when URL output is
available.
b64_json:
type: string
description: >-
Base64-encoded image payload when inline output
is available.
revised_prompt:
type: string
description: Provider-rewritten prompt, when available.
fail_reason:
type: string
description: Failure reason when the task status is `failure`.
example:
code: success
data:
task_id:
status: success
data:
- url:
b64_json:
revised_prompt:
examples:
pending:
summary: Pending task
value:
code: success
data:
task_id:
status: pending
data: []
success:
summary: Finished task
value:
code: success
data:
task_id:
status: success
data:
- url:
b64_json:
revised_prompt:
failure:
summary: Failed task
value:
code: success
data:
task_id:
status: failure
data: []
fail_reason:
x-codeSamples:
- lang: Shell
label: Poll until done
source: |
TASK_ID=""
while true; do
RESPONSE=$(curl -s "https://api.cometapi.com/v1/images/generations/$TASK_ID" \
-H "Authorization: Bearer $COMETAPI_KEY")
STATUS=$(printf "%s" "$RESPONSE" | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['status'])")
echo "status: $STATUS"
case "$STATUS" in success | failure) break;; esac
sleep 3
done
printf "%s\n" "$RESPONSE"
- lang: Python
label: Poll until done
source: |
import os
import time
import requests
task_id = ""
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
while True:
task = requests.get(
f"https://api.cometapi.com/v1/images/generations/{task_id}",
headers=headers,
).json()
status = task["data"]["status"]
print(status)
if status in ("success", "failure"):
break
time.sleep(3)
if status == "success":
print(task["data"]["data"][0].keys())
- lang: JavaScript
label: Poll until done
source: >
const taskId = "";
const headers = { Authorization: `Bearer
${process.env.COMETAPI_KEY}` };
let task;
while (true) {
const response = await fetch(
`https://api.cometapi.com/v1/images/generations/${taskId}`,
{ headers },
);
task = await response.json();
const status = task.data.status;
console.log(status);
if (status === "success" || status === "failure") break;
await new Promise((resolve) => setTimeout(resolve, 3000));
}
if (task.data.status === "success") {
console.log(Object.keys(task.data.data[0]));
}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````