> ## 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.
# Recuperare un task immagine Seedream
> Usa CometAPI GET /v1/images/generations/{task_id} per interrogare un task asincrono di generazione immagini Seedream e recuperare i dati finali dell'immagine.
Usa questo endpoint dopo aver creato un'immagine Seedream con `POST /v1/images/generations` e `async: true`. La richiesta di creazione restituisce `data.task_id`, e questo endpoint restituisce lo stato del task insieme ai dati finali dell'immagine quando il task va a buon fine.
## Interrogare un task immagine Seedream
Invia `POST /v1/images/generations` con `async: true`, quindi memorizza `data.task_id`.
Chiama questo endpoint con il task ID memorizzato finché `data.status` non è `success` o `failure`.
Quando `data.status` è `success`, leggi il primo elemento in `data.data`. I risultati asincroni di Seedream possono includere `url`, `b64_json` e `revised_prompt`.
## Valori di stato
* `pending`: Il task è in coda o in fase di generazione.
* `success`: Il task è stato completato e `data.data` contiene i dati dell'immagine generata.
* `failure`: Il task non è riuscito. Controlla `data.fail_reason` quando viene restituito.
## 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.
````