跳转到主要内容
千问云 home page
开放平台文档
图生动作

Wan — 查询结果

查询动画生成状态

GET
/tasks/{task_id}
cURL - 查询任务结果
# 将 {task_id} 替换为提交响应中返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-18 15:32:00.105",
    "scheduled_time": "2025-09-18 15:32:15.066",
    "end_time": "2025-09-18 15:34:41.898",
    "results": {
      "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
    }
  },
  "usage": {
    "video_duration": 5.2,
    "video_ratio": "standard"
  }
}
查询任务状态并获取生成的动画。

轮询策略

  1. 调用创建任务接口获取 task_id。
  2. 每 15 秒轮询一次，直到 task_status 为 SUCCEEDED、FAILED 或 CANCELED。
  3. 任务成功后，从 output.results.video_url 获取动画。

注意事项

  • URL 有效期：动画 URL 在 24 小时后过期，请及时下载。
  • 状态流转：PENDING → RUNNING → SUCCEEDED、FAILED 或 CANCELED。UNKNOWN 表示任务不存在或查询已超过 24 小时。

鉴权

​
string
header
必填

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

路径参数

​
string
必填

POST 接口返回的任务 ID。

响应

200-application/json
​
string

唯一请求标识符。

示例:a67f8716-18ef-447c-a286-xxxxxx
​
object
​
object

输出统计信息，仅在任务成功时返回。