跳转到主要内容
首帧

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": "c1209113-8437-424f-a386-xxxxxx",
  "output": {
    "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
    "task_status": "SUCCEEDED",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "video_count": 1,
    "video_duration": 5
  }
}
查询任务状态并获取生成的视频。

轮询策略

  1. 创建任务,获取 task_id
  2. 15 秒轮询一次,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,从 video_url 获取视频。

注意事项

  • URL 有效期:视频 URL 在 24 小时后过期,请及时下载。
  • 状态流转PENDINGRUNNINGSUCCEEDEDFAILED

鉴权

string
header
必填

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

路径参数

string
必填

POST 接口返回的任务 ID。

响应

200-application/json
string

唯一请求标识符。

2ca1c497-f9e0-449d-9a3f-xxxxxx
object
object

输出统计信息。仅在任务成功时返回,具体字段因模型版本而异。