跳转到主要内容
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": "kyyvideo2_fast",
  "status": "queued",
  "video_url": null,
  "error": null
}

​
KyyVideo2 查询视频任务

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

​
认证

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

​
路径参数

​
id
string
必填
视频生成任务的唯一标识符，从创建任务接口返回示例：video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

​
响应参数

​
id
string
视频生成任务的唯一标识符
​
object
string
对象类型，固定为 video
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称（kyyvideo2、kyyvideo2_fast、kyyvideo2_pro、kyyvideo2_fast_pro）
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
video_url
string
生成的视频URL，当 status 为 completed 时返回
​
error
string
错误信息，当 status 为 failed 时返回

​
状态流程

1

queued

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

processing

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

completed

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

​
轮询建议

轮询策略：
  • 建议轮询间隔：20-40 秒
  • 快速模型（kyyvideo2_fast、kyyvideo2_fast_pro）生成速度更快，可适当缩短轮询间隔
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completed 或 failed 时停止轮询

​
视频URL说明

重要提示：
  • 生成的视频URL有效期通常为 24 小时
  • 请及时下载并保存视频到你的存储系统
  • URL 过期后将无法访问视频
  • 视频文件通常为 MP4 格式
  • 根据 generateAudio 参数，视频可能包含或不包含音频

​
生成时间预估

标准模型

kyyvideo2 / kyyvideo2_pro预计生成时间：2-5 分钟

快速模型

kyyvideo2_fast / kyyvideo2_fast_pro预计生成时间：1-3 分钟
影响生成时间的因素：
  • 视频时长：时长越长，生成时间越长
  • 模型类型：快速模型生成速度更快
  • 参考素材：使用多模态参考（图片、视频、音频）可能增加处理时间
  • 系统负载：高峰期可能需要更长的排队时间

​
模型生成速度对比

模型平均生成时间适用场景
kyyvideo22-5 分钟标准质量，支持参考视频
kyyvideo2_fast1-3 分钟快速生成，支持参考视频
kyyvideo2_pro3-6 分钟高质量输出
kyyvideo2_fast_pro2-4 分钟高质量快速生成
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": "kyyvideo2_fast",
  "status": "queued",
  "video_url": null,
  "error": null
}