Qwen Image 3.0 图像任务状态查询

来源：ModelVerse（astraflow.ucloud.cn）查询异步图像任务的执行状态、结果 URL 与用量信息。

认证

通过请求头传入 API Key：


Authorization: Bearer <MODELVERSE_API_KEY>

请求地址


GET https://api.modelverse.cn/v1/tasks/status

请求参数

参数	位置	类型	必填	说明
`task_id`	query	string	是	由 `POST /v1/tasks/submit` 返回的异步任务标识

响应（200）

成功任务示例


{
  "output": {
    "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
    "task_status": "Success",
    "urls": [
      "https://example.com/generated-image-1.png"
    ],
    "submit_time": 1775115000,
    "finish_time": 1775115038
  },
  "usage": {
    "image_count": 1,
    "input_image_count": 0,
    "pixel_count": 1048576
  },
  "request_id": ""
}

失败任务示例


{
  "output": {
    "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
    "task_status": "Failure",
    "submit_time": 1775115000,
    "finish_time": 1775115012,
    "error_message": "code=InvalidParameter, message=invalid image url"
  },
  "request_id": ""
}

响应字段说明

顶层字段：

字段	类型	必有	说明
`output`	object	是	任务状态输出
`usage`	object	否	用量信息
`request_id`	string	是	请求标识

output 对象：

字段	类型	必有	说明
`task_id`	string	是	异步任务标识
`task_status`	string	是	任务状态：`Pending` / `Running` / `Success` / `Failure` / `Cancelled`
`urls`	string[]	否	生成图像结果 URL 列表，链接有效期为 24 小时
`submit_time`	integer	否	任务提交时间戳
`finish_time`	integer	否	任务完成时间戳
`error_message`	string	否	任务失败时返回的错误信息

usage 对象：

字段	类型	说明
`image_count`	integer	实际生成的输出图片数量
`input_image_count`	integer	请求中输入图片的数量，文生图（T2I）时为 0，图生图（I2I）按实际输入图片数返回
`pixel_count`	integer	输出图片像素值（宽×高），用于按像素分档计费

错误响应（400 / default）

400 — 任务标识无效或任务状态查询失败
default — 其他错误


{
  "error": {
    "code": "InvalidParameter",
    "message": "invalid task_id"
  },
  "request_id": "req_202604021530000001"
}

字段	类型	说明
`error.code`	string	错误码，如 `InvalidParameter`
`error.message`	string	错误信息，如 `invalid task_id`
`request_id`	string	可选的请求标识

备注

结果图片 URL 有效期为 24 小时，请及时下载保存
该接口与 POST /v1/tasks/submit（异步提交）、POST /v1/images/generations（同步生成）同属 qwen-image-3.0 / qwen-image-3.0-pro 接口文档