跳转到主要内容
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/vgen_abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "processing",
  "video_url": null,
  "error": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.globalaiopc.com/llms.txt

Use this file to discover all available pages before exploring further.

VEO 查询视频任务

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

认证

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

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

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 时返回
error
string
错误信息,当 status 为 failed 时返回

状态流程

1

queued

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

processing

任务正在处理中,VEO 模型正在生成视频
3

completed

任务完成,视频生成成功,可通过 video_url 获取结果

轮询建议

轮询策略:
  • 建议轮询间隔:30-60 秒
  • VEO 生成速度相对较快,通常 2-5 分钟完成
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completedfailed 时停止轮询

视频URL说明

重要提示:
  • 生成的视频URL有效期通常为 24 小时
  • 请及时下载并保存视频到你的存储系统
  • URL 过期后将无法访问视频
  • 视频文件通常为 MP4 格式,固定 8 秒时长

生成时间预估

参考图片模式

预计生成时间:2-4 分钟

首尾帧模式

预计生成时间:3-5 分钟
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/vgen_abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "processing",
  "video_url": null,
  "error": null
}