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

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": "8f240644-efe8-43bf-86ff-xxxxxx",
  "output": {
    "task_id": "b7e05baa-c318-440d-b293-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 15:10:42.723",
    "scheduled_time": "2026-03-27 15:10:42.754",
    "end_time": "2026-03-27 15:11:17.388",
    "orig_prompt": "男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣",
    "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx"
  },
  "usage": {
    "duration": 5,
    "size": "960*528",
    "output_video_duration": 5,
    "fps": 24,
    "audio": false,
    "SR": "540",
    "video_count": 1,
    "reference_type": "image,video"
  }
}
提交任务后使用此接口轮询结果，任务提交方式参见生成视频。

轮询策略

  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
必填

创建任务接口返回的任务 ID。查询有效期为 24 小时。

响应

200-application/json
​
string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:8f240644-efe8-43bf-86ff-xxxxxx
​
object

任务输出信息。

​
object

输出信息统计。只对成功的结果计数。