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

Wan 2.7 — 查询结果

查询 Wan 2.7 图像任务状态

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": "2026-03-31 19:57:58.840",
    "scheduled_time": "2026-03-31 19:57:58.877",
    "end_time": "2026-03-31 19:58:11.563",
    "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"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "size": "2985*1405",
    "total_tokens": 18792,
    "image_count": 1,
    "output_tokens": 2,
    "input_tokens": 18790
  }
}
查询任务状态和结果。

轮询策略

使用返回的 task_id 轮询此接口，建议每 5-10 秒轮询一次。

注意事项

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

鉴权

​
string
header
必填

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

路径参数

​
string
必填

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

响应

200-application/json
​
string

唯一请求标识符。

示例:43d9e959-25bc-4dc7-9888-xxxxxx
​
object
​
object

用量统计。仅在 task_status 为 SUCCEEDED 时存在。