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

POST /v1/images/generations 및 async: true로 Seedream 이미지를 생성한 후 이 엔드포인트를 사용하세요. 생성 요청은 data.task_id를 반환하며, 이 엔드포인트는 작업이 성공하면 작업 상태와 최종 이미지 데이터를 반환합니다. 이 워크플로는 doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128, seedream-5-0-pro-260628를 지원합니다. 계정에서 사용할 수 있는지 확인하려면 모델 페이지 또는 /v1/models를 확인하세요.

Seedream 이미지 작업 폴링

작업 생성

POST /v1/images/generations를 사용하여 async: true를 전송한 다음 data.task_id를 저장하세요.

작업 폴링

저장된 작업 ID로 이 엔드포인트를 호출하여 data.status가 success 또는 failure가 될 때까지 폴링하세요.

이미지 데이터 읽기

data.status가 success이면 data.data[0].url를 읽으세요. URL 워크플로에서는 b64_json 및 revised_prompt를 포함한 다른 결과 필드가 비어 있을 수 있습니다.

반환된 이미지를 즉시 다운로드하거나 전송하세요. 결과 URL은 임시이므로 고정된 유지 기간에 의존하지 마세요.

상태 값

pending: 작업이 대기 중이거나 생성 중입니다.
success: 작업이 완료되었으며 data.data에 생성된 이미지 데이터가 포함됩니다.
failure: 작업이 실패했습니다. 반환되는 경우 data.fail_reason를 확인하세요.

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

task_id

string

필수

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

응답

200 - application/json

Current Seedream image generation task state.

code

string

필수

Request status code. Successful task lookups return success.

예시:

"success"

message

string

필수

Status message. Successful lookups can return an empty string.

data

object

필수

Show child attributes

마지막 수정일 2026년 7월 31일

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

콘텐츠 검토

API 키

Seedream 이미지 작업 폴링

상태 값

인증

경로 매개변수

응답

​Seedream 이미지 작업 폴링

​상태 값

인증

경로 매개변수

응답

Seedream 이미지 작업 폴링

상태 값