跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
kyyvideo2
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/kyyvideo2/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kyyvideo2",
    "prompt": "一只猫在雨中跳舞，电影风格",
    "duration": 10,
    "aspect_ratio": "16:9",
    "generateAudio": true
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "kyyvideo2_fast",
  "status": "queued",
  "error": null
}

​
KyyVideo2 创建视频任务

使用 KyyVideo2 的先进 AI 模型创建高质量视频生成任务，支持多种模型选项和多模态参考输入。

​
认证

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

​
请求参数

​
model
string
必填
模型名称，可选值：
  • kyyvideo2 - 标准模型（支持参考视频）
  • kyyvideo2_fast - 快速模型（支持参考视频）
  • kyyvideo2_pro - Pro 模型（不支持参考视频）
  • kyyvideo2_fast_pro - Fast Pro 模型（不支持参考视频）
​
prompt
string
必填
视频生成提示词，描述所需的视频内容示例："一只猫在雨中跳舞，电影风格"
​
duration
integer
视频时长（秒），默认 5 秒，范围 4-15 秒
​
first_image
string
首帧图 URL，用于图生视频场景使用场景：
  • 单独使用：图生视频-首帧场景
  • 搭配 last_image：首尾帧场景
格式要求：
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
与 referenceImages/referenceVideos/referenceAudios 互斥
​
last_image
string
尾帧图 URL，用于首尾帧场景格式要求：
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
必须搭配 first_image 使用
​
aspect_ratio
string
输出视频宽高比，默认 16:9可选值：
  • 16:9 - 横屏
  • 4:3 - 标准
  • 1:1 - 正方形
  • 3:4 - 竖屏
  • 9:16 - 竖屏
  • 21:9 - 超宽屏
  • adaptive - 自适应
​
generateAudio
boolean
是否生成同步音频，默认 true
  • true：输出视频包含同步音频
  • false：输出视频为无声视频
​
referenceAudios
array
多模态参考音频列表格式要求：
  • 格式：wav、mp3
  • 时长：单个音频 2-15 秒，最多 3 段，总时长 ≤ 15 秒
  • 大小：单个 ≤ 15 MB
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
与 first_image/last_image 互斥
​
referenceImages
array
多模态参考图片列表格式要求：
  • 数量：1-9 张
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
涉及人脸或虚拟人像需先上传素材库审核
与 first_image/last_image 互斥
​
referenceVideos
array
多模态参考视频列表格式要求：
  • 分辨率：480p、720p
  • 时长：单个视频 2-15 秒，最多 3 个，总时长 ≤ 15 秒
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
系统会自动选择最优后端模型
与 first_image/last_image 互斥

​
响应参数

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

​
模型特性

kyyvideo2

标准模型，支持参考视频，适合常规视频生成

kyyvideo2_fast

快速模型，支持参考视频，生成速度更快

kyyvideo2_pro

Pro 模型，不支持参考视频，质量更高

kyyvideo2_fast_pro

Fast Pro 模型，不支持参考视频，速度与质量兼顾

​
参数选择规则

参数互斥规则：
  • 首尾帧场景：使用 first_image 和 last_image 时，不能使用 referenceImages、referenceVideos、referenceAudios
  • 多模态参考：使用 referenceImages、referenceVideos、referenceAudios 时，不能使用 first_image、last_image

​
模型功能对比

模型参考视频支持生成速度视频质量
kyyvideo2✅ 支持标准标准
kyyvideo2_fast✅ 支持快速标准
kyyvideo2_pro❌ 不支持标准高质量
kyyvideo2_fast_pro❌ 不支持快速高质量
最佳实践：
  1. 视频生成为异步处理，需要通过返回的 id 查询任务状态和结果
  2. 在提示词中明确描述所需的视觉效果和风格
  3. 根据需求选择合适的模型：需要参考视频时选择标准或快速模型，追求质量时选择 Pro 模型
  4. 参考图片涉及人脸时，需先上传素材库进行审核
  5. 合理设置视频时长（4-15 秒），时长越短生成越快
提示词建议：
  • 包含具体的场景描述
  • 添加风格关键词（如 “电影风格”、“艺术风格”、“写实风格”）
  • 描述动作和运动方式
  • 指定光照和色彩偏好
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/kyyvideo2/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kyyvideo2",
    "prompt": "一只猫在雨中跳舞，电影风格",
    "duration": 10,
    "aspect_ratio": "16:9",
    "generateAudio": true
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "kyyvideo2_fast",
  "status": "queued",
  "error": null
}