跳转到主要内容
千问云 home page
开放平台文档
万相2.6

Wan 2.6 — 查询结果

查询 Wan 2.6 图像任务状态

GET
/tasks/{task_id}
cURL - Query task result
# 将 {task_id} 替换为前一个 API 调用返回的 task_id 值。
# task_id 有效期为 24 小时。
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
  "output": {
    "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-12-16 04:21:02.275",
    "scheduled_time": "2025-12-16 04:21:02.304",
    "end_time": "2025-12-16 04:24:46.658",
    "finished": true,
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result.oss-cn-shanghai.aliyuncs.com/1xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      },
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result.oss-cn-shanghai.aliyuncs.com/2xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "size": "1376*768",
    "total_tokens": 0,
    "image_count": 2,
    "output_tokens": 0,
    "input_tokens": 0
  }
}
查询任务状态和结果。

轮询策略

使用返回的 task_id 轮询此接口，建议轮询间隔为 5-10 秒。

注意事项

  • URL 有效期：图片 URL 在 24 小时后过期，请及时下载。
  • 任务状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。
  • 其他状态：CANCELED（任务已取消）、UNKNOWN（task_id 无效或已过期）。
  • task_id 有效期：task_id 有效期为 24 小时，过期后无法查询任务状态和结果。
  • 避免重复提交：请通过轮询获取结果，不要重复提交请求。

鉴权

​
string
header
必填

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

路径参数

​
string
必填

异步任务创建接口返回的任务标识符。

响应

200-application/json
​
string

用于排查问题的唯一请求标识符。

​
object

任务输出信息。

​
object

用量统计，仅统计成功生成的结果。

​
string

错误码，仅在请求失败时返回。

​
string

详细错误信息，仅在请求失败时返回。