千问

Qwen — 查询图像生成结果

查询图像生成任务状态

GET

/tasks/{task_id}

cURL

# 将 {task_id} 替换为提交响应中返回的实际任务 ID
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "7434edb2-3cba-44e6-a772-xxxxxxxxxxxx",
  "output": {
    "task_id": "878f591e-ebdf-4e45-97eb-xxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-09 11:38:54.741",
    "scheduled_time": "2025-09-09 11:38:54.781",
    "end_time": "2025-09-09 11:39:19.484",
    "results": [
      {
        "orig_prompt": "a cute cat",
        "actual_prompt": "a cute cat, high quality",
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      }
    ],
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 1
  }
}

通过异步接口提交请求后，使用此接口轮询任务状态。任务结果将在 24 小时后过期，请及时下载生成的图像。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

异步任务提交时返回的任务 ID。

响应

200-application/json

string

默认值"7434edb2-3cba-44e6-a772-xxxxxx"

唯一请求标识符。

object

显示子属性

string

任务 ID。

enum<string>

当前任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED

string

任务提交时间。

string

任务调度执行时间。

string

任务完成时间。

string

错误码。仅当 task_status 为 FAILED 时返回。

string

错误信息。仅当 task_status 为 FAILED 时返回。

object[]

生成的图像结果。仅当 task_status 为 SUCCEEDED 时返回。

显示子属性

string

用户提交的原始提示词。

string

实际用于生成的提示词（启用 prompt_extend 时可能与原始提示词不同）。

string

生成图像的 URL。有效期 24 小时。

object

任务完成度统计。

显示子属性

integer

请求生成的图像总数。

integer

成功生成的图像数量。

integer

生成失败的图像数量。

object

默认值"{\"image_count\":1}"

用量统计。

显示子属性

integer

成功生成的图像数量。

cURL

# 将 {task_id} 替换为提交响应中返回的实际任务 ID
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "7434edb2-3cba-44e6-a772-xxxxxxxxxxxx",
  "output": {
    "task_id": "878f591e-ebdf-4e45-97eb-xxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-09 11:38:54.741",
    "scheduled_time": "2025-09-09 11:38:54.781",
    "end_time": "2025-09-09 11:39:19.484",
    "results": [
      {
        "orig_prompt": "a cute cat",
        "actual_prompt": "a cute cat, high quality",
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      }
    ],
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 1
  }
}