> ## 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.
# Récupérer une tâche d’image Seedream
> Utilisez CometAPI GET /v1/images/generations/{task_id} pour interroger une tâche asynchrone de génération d’image Seedream et récupérer les données finales de l’image.
Utilisez ce endpoint après avoir créé une image Seedream avec `POST /v1/images/generations` et `async: true`. La requête de création renvoie `data.task_id`, et ce endpoint renvoie l’état de la tâche ainsi que les données finales de l’image lorsque la tâche réussit.
## Interroger une tâche d’image Seedream
Envoyez `POST /v1/images/generations` avec `async: true`, puis stockez `data.task_id`.
Appelez ce endpoint avec l’ID de tâche stocké jusqu’à ce que `data.status` soit `success` ou `failure`.
Lorsque `data.status` est `success`, lisez le premier élément de `data.data`. Les résultats asynchrones Seedream peuvent inclure `url`, `b64_json` et `revised_prompt`.
## Valeurs de statut
* `pending`: La tâche est en file d’attente ou en cours de génération.
* `success`: La tâche est terminée et `data.data` contient les données de l’image générée.
* `failure`: La tâche a échoué. Vérifiez `data.fail_reason` lorsqu’il est renvoyé.
## 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.
````