Recuperare un task di immagine Seedream

GET

images

generations

{task_id}

cURL

curl "https://api.cometapi.com/v1/images/generations/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os
import time
import requests

task_id = "<task_id>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

for _ in range(60):
    response = requests.get(
        f"https://api.cometapi.com/v1/images/generations/{task_id}",
        headers=headers,
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()
    status = task["data"]["status"]
    print(status)

    if status == "success":
        print(task["data"]["data"][0]["url"])
        break
    if status == "failure":
        raise RuntimeError(task["data"].get("fail_reason", "Seedream task failed"))

    time.sleep(5)
else:
    raise TimeoutError("Seedream task did not finish in time")

const taskId = "<task_id>";
const headers = { Authorization: `Bearer ${process.env.COMETAPI_KEY}` };

for (let attempt = 0; attempt < 60; attempt += 1) {
  const response = await fetch(
    `https://api.cometapi.com/v1/images/generations/${taskId}`,
    { headers, signal: AbortSignal.timeout(30_000) },
  );
  if (!response.ok) throw new Error(await response.text());

  const task = await response.json();
  const status = task.data.status;
  console.log(status);

  if (status === "success") {
    console.log(task.data.data[0].url);
    break;
  }
  if (status === "failure") {
    throw new Error(task.data.fail_reason ?? "Seedream task failed");
  }
  if (attempt === 59) throw new Error("Seedream task did not finish in time");

  await new Promise((resolve) => setTimeout(resolve, 5000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/images/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/images/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/images/generations/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "<task_id>",
    "status": "pending",
    "data": []
  }
}

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 e i dati finali dell’immagine quando il task ha esito positivo. Questo flusso di lavoro supporta doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128 e seedream-5-0-pro-260628. Consulta la pagina Models o /v1/models per verificare la disponibilità dell’account.

Eseguire il polling di un task di immagine Seedream

Crea il task

Invia POST /v1/images/generations con async: true, quindi salva data.task_id.

Esegui il polling del task

Chiama questo endpoint con l’ID del task salvato finché data.status non è success o failure.

Leggi i dati dell'immagine

Quando data.status è success, leggi data.data[0].url. Altri campi del risultato, inclusi b64_json e revised_prompt, possono essere vuoti nel flusso di lavoro con URL.

Scarica o trasferisci tempestivamente l’immagine restituita. L’URL del risultato è temporaneo; non fare affidamento su una durata fissa.

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 ha avuto esito negativo. Verifica data.fail_reason quando viene restituito.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

task_id

string

obbligatorio

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

Risposta

200 - application/json

Current Seedream image generation task state.

code

string

obbligatorio

Request status code. Successful task lookups return success.

Esempio:

"success"

message

string

obbligatorio

Status message. Successful lookups can return an empty string.

data

object

obbligatorio

Show child attributes

Ultima modifica il 31 luglio 2026

cURL

curl "https://api.cometapi.com/v1/images/generations/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os
import time
import requests

task_id = "<task_id>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

for _ in range(60):
    response = requests.get(
        f"https://api.cometapi.com/v1/images/generations/{task_id}",
        headers=headers,
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()
    status = task["data"]["status"]
    print(status)

    if status == "success":
        print(task["data"]["data"][0]["url"])
        break
    if status == "failure":
        raise RuntimeError(task["data"].get("fail_reason", "Seedream task failed"))

    time.sleep(5)
else:
    raise TimeoutError("Seedream task did not finish in time")

const taskId = "<task_id>";
const headers = { Authorization: `Bearer ${process.env.COMETAPI_KEY}` };

for (let attempt = 0; attempt < 60; attempt += 1) {
  const response = await fetch(
    `https://api.cometapi.com/v1/images/generations/${taskId}`,
    { headers, signal: AbortSignal.timeout(30_000) },
  );
  if (!response.ok) throw new Error(await response.text());

  const task = await response.json();
  const status = task.data.status;
  console.log(status);

  if (status === "success") {
    console.log(task.data.data[0].url);
    break;
  }
  if (status === "failure") {
    throw new Error(task.data.fail_reason ?? "Seedream task failed");
  }
  if (attempt === 59) throw new Error("Seedream task did not finish in time");

  await new Promise((resolve) => setTimeout(resolve, 5000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/images/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/images/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/images/generations/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "<task_id>",
    "status": "pending",
    "data": []
  }
}

Moderazione dei contenuti

Chiavi API

Recuperare un task di immagine Seedream

Eseguire il polling di un task di immagine Seedream

Valori di stato

Autorizzazioni

Parametri del percorso

Risposta

​Eseguire il polling di un task di immagine Seedream

​Valori di stato

Autorizzazioni

Parametri del percorso

Risposta

Eseguire il polling di un task di immagine Seedream

Valori di stato