Bir Seedream görsel görevini alma

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": []
  }
}

Bir Seedream görselini POST /v1/images/generations ve async: true ile oluşturduktan sonra bu endpoint’i kullanın. Oluşturma isteği data.task_id döndürür; görev başarılı olduğunda bu endpoint görev durumunu ve nihai görsel verilerini döndürür. Bu iş akışı doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128 ve seedream-5-0-pro-260628 destekler. Hesap kullanılabilirliği için Modeller sayfasını veya /v1/models öğesini kontrol edin.

Bir Seedream görsel görevini sorgulama

Görevi oluşturun

POST /v1/images/generations öğesini async: true ile gönderin, ardından data.task_id öğesini saklayın.

Görevi sorgulayın

Saklanan görev kimliğiyle bu endpoint’i, data.status success veya failure olana kadar çağırın.

Görsel verilerini okuyun

data.status success olduğunda, data.data[0].url öğesini okuyun. b64_json ve revised_prompt dahil diğer sonuç alanları, URL iş akışında boş olabilir.

Döndürülen görseli hemen indirin veya aktarın. Sonuç URL’si geçicidir; sabit bir geçerlilik süresine güvenmeyin.

Durum değerleri

pending: Görev kuyruğa alınmış veya oluşturuluyordur.
success: Görev tamamlandı ve data.data oluşturulan görsel verilerini içerir.
failure: Görev başarısız oldu. Döndürüldüğünde data.fail_reason öğesini kontrol edin.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

task_id

string

gerekli

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

Yanıt

200 - application/json

Current Seedream image generation task state.

code

string

gerekli

Request status code. Successful task lookups return success.

Örnek:

"success"

message

string

gerekli

Status message. Successful lookups can return an empty string.

data

object

gerekli

Show child attributes

Son değiştirilme tarihi 31 Temmuz 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": []
  }
}

İçerik moderasyonu

API anahtarları

Bir Seedream görsel görevini sorgulama

Durum değerleri

Yetkilendirmeler

Yol Parametreleri

Yanıt

​Bir Seedream görsel görevini sorgulama

​Durum değerleri

Yetkilendirmeler

Yol Parametreleri

Yanıt

Bir Seedream görsel görevini sorgulama

Durum değerleri