MAPI
图像(Images)异步图像任务

查询异步图像生成任务

通过任务 ID 查询图像生成任务的当前状态和结果。

建议轮询间隔:3–5 秒。任务通常在 10–90 秒内完成。

任务完成后(status=SUCCESS),images[] 字段返回所有生成图片的 URL 或 Base64 数据,支持多张(n>1 时多项)。

GET
/v2/image-tasks/{task_id}

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Path Parameters

task_id*string

任务 ID(由 POST /v2/image-tasks 返回的 data.task_id 字段)

Response Body

application/json

curl -X GET "https://loading/v2/image-tasks/string"
{
  "code": "success",
  "data": {
    "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
    "status": "SUCCESS",
    "progress": "100%",
    "model": "doubao-seedream-4-5-251128",
    "images": [
      {
        "url": "https://example.com/generated.png"
      }
    ],
    "amount": "0.014000",
    "usage": {
      "input_tokens": 0,
      "output_tokens": 0,
      "total_tokens": 0
    },
    "fail_reason": "string",
    "created_at": 0,
    "submit_time": 0,
    "finish_time": 0
  }
}

最后更新于