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 画像タスクをポーリングする

​ステータス値

承認

パスパラメータ

レスポンス

Seedream 画像タスクをポーリングする

ステータス値