跳转到主要内容
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "processing",
  "video_url": null,
  "totalTokens": null,
  "error": null
}

​
Vidu 查询视频任务

使用任务 ID 查询 Vidu 视频生成任务的状态和结果。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
路径参数

​
id
string
必填
视频生成任务的唯一标识符，从创建任务接口返回

​
响应参数

​
id
string
视频生成任务的唯一标识符
​
object
string
对象类型，固定为 Video
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
video_url
string
生成的视频URL，当 status 为 completed 时返回
​
actualDuration
number
视频实际输出时长（秒），当 status 为 completed 时返回
​
totalTokens
number
任务消耗的总 token 数
​
error
string
错误信息，当 status 为 failed 时返回

​
状态流程

1

queued

任务已创建并加入队列，等待处理
2

processing

任务正在处理中，Vidu 模型正在生成视频
3

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 分钟
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "processing",
  "video_url": null,
  "totalTokens": null,
  "error": null
}