获取 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 图像任务

状态值