跳转到主要内容
千问 AI 平台 home page
文档
视频生成

万相数字人 — 查询结果

查询 wan2.2-s2v 数字人视频生成任务状态和结果

GET
/tasks/{task_id}
cURL
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "output": {
    "task_id": "bcae8761-f242-4775-a11e-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-01 09:37:27.468",
    "scheduled_time": "2025-09-01 09:37:34.885",
    "end_time": "2025-09-01 09:40:20.734",
    "results": {
      "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/1d/xxx.mp4?Expires=xxxxxx"
    }
  },
  "usage": {
    "duration": 18.13,
    "size": "512*640",
    "fps": 16,
    "video_count": 1,
    "SR": 480
  },
  "request_id": "28cfedb1-cd60-9e0c-b920-xxxxxx"
}
查询任务状态和结果。

轮询策略

使用返回的 task_id 轮询此接口，建议每 15 秒轮询一次（视频生成耗时约 5-10 分钟）。

注意事项

  • URL 有效期：视频 URL 在 24 小时后过期，请及时下载。
  • 视频时长：生成视频的时长与输入音频的时长一致，因此单次生成的视频时长同样受音频时长限制（须小于 20 秒）；若输入音频超过 20 秒，会导致任务报错。如需生成更长的视频，可将长音频按小于 20 秒切分为多段，分别调用创建任务接口生成对应的视频片段，再使用剪辑工具将多段视频拼接合并为一个完整的长视频。
  • 任务状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。
  • 其他状态：CANCELED（任务已取消）、UNKNOWN（任务 ID 无效或已过期）。
  • task_id 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。
  • 避免重复提交：请通过轮询获取结果，不要重复提交请求。

鉴权

​
string
header
必填

千问 AI 平台 API Key。详见获取 API Key。

路径参数

​
string
必填

需要查询任务的ID。

响应

200-application/json
​
object
​
object
​
string

本次请求的唯一ID。

示例:7574ee8f-38a3-4b1e-9280-11c33ab46e51