跳转到主要内容
千问云 home page
开放平台文档
首帧

Vidu — 查询结果

查询 Vidu 图生视频任务的状态和结果。

GET
/tasks/{task_id}
cURL
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "3606f9f4-b833-44ec-8385-xxxxxx",
  "output": {
    "task_id": "2846881f-0496-4288-947f-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 14:25:32.057",
    "scheduled_time": "2026-03-27 14:25:32.084",
    "end_time": "2026-03-27 14:28:29.600",
    "orig_prompt": "镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。",
    "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxxx"
  },
  "usage": {
    "duration": 5,
    "size": "988*932",
    "output_video_duration": 5,
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}
在通过生成视频接口提交任务后，轮询此接口获取结果。

轮询策略

  1. 调用生成视频接口获取 task_id。
  2. 每隔 15 秒轮询，直到 task_status 变为 SUCCEEDED 或 FAILED。
  3. 成功后，从 output.video_url 下载视频。

注意事项

  • URL 有效期：视频 URL 自任务完成起 24 小时内有效，请及时下载。
  • 状态转换：PENDING → RUNNING → SUCCEEDED 或 FAILED。UNKNOWN 表示任务不存在或已过期。

鉴权

​
string
header
必填

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

路径参数

​
string
必填

POST 接口返回的任务 ID。

响应

200-application/json
​
string

唯一请求标识符。

示例:3606f9f4-b833-44ec-8385-xxxxxx
​
object
​
object

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