mingyan
Vidu - 查询任务
查询 Vidu 视频生成任务的状态和结果
Vidu 查询视频任务
使用任务 ID 查询 Vidu 视频生成任务的状态和结果。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。路径参数
idstring必填视频生成任务的唯一标识符，从创建任务接口返回
响应参数
idstring视频生成任务的唯一标识符
objectstring对象类型，固定为
Videocreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中completed- 已完成failed- 失败
video_urlstring生成的视频URL，当 status 为
completed 时返回actualDurationnumber视频实际输出时长（秒），当 status 为
completed 时返回totalTokensnumber任务消耗的总 token 数
errorstring错误信息，当 status 为
failed 时返回状态流程
queued
任务已创建并加入队列，等待处理
processing
任务正在处理中，Vidu 模型正在生成视频
completed
任务完成，视频生成成功，可通过
video_url 获取结果轮询建议
轮询策略：
- 建议轮询间隔：30-60 秒
- Vidu 生成速度因模型而异：
- viduq3-turbo：通常 2-4 分钟完成
- viduq3-pro：通常 3-6 分钟完成
- 避免过于频繁的请求以免触发限流
- 当状态为
completed或failed时停止轮询
视频URL说明
重要提示：
- 生成的视频URL有效期通常为 24 小时
- 请及时下载并保存视频到你的存储系统
- URL 过期后将无法访问视频
- 视频文件通常为 MP4 格式
生成时间预估
Vidu Q3 Turbo
速度优先
预计生成时间：2-4 分钟
Vidu Q3 Pro
质量优先
预计生成时间：3-6 分钟