APIAPI
API

Videos - 创建任务

使用 Videos 系列模型创建视频生成任务，支持纯文生、首尾帧和图/视频参考；部分模型支持音频参考

POST/kyyReactApiServer/v1/videos/videos

Videos 创建视频任务

使用 Videos 系列模型创建视频生成任务，支持 videos、videos_stable、videos_stable_fast、videos_pro 和 videos_pro_fast。接口支持纯文生、首尾帧、多图参考、视频参考和音频参考；其中 videos、videos_pro、videos_pro_fast 最多支持 3 段音频，videos_stable / videos_stable_fast 最多支持 1 段音频。

认证

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

基础 URL

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

模型介绍

支持的模型：
  • videos：Videos 标准模型，按次计费，支持更多画幅和音频参考；最多支持 9 张参考图片、3 个参考视频、3 段参考音频。
  • videos_stable：Video2 满血模型，按次计费；最多支持 4 张参考图片、3 个参考视频、1 段参考音频。
  • videos_stable_fast：Video2 快速模型，按次计费；最多支持 4 张参考图片、3 个参考视频、1 段参考音频。
  • videos_pro：Seedance 标准模型，按次计费；最多支持 9 张参考图片、0 个参考视频、3 段参考音频，音频不能作为唯一参考输入。
  • videos_pro_fast：Seedance 快速模型，按次计费；最多支持 9 张参考图片、0 个参考视频、3 段参考音频，音频不能作为唯一参考输入。

请求参数

modelbodystring必填
模型名称。
可选值：
  • videos - Videos 标准模型，支持音频参考
  • videos_stable - Video2 满血模型
  • videos_stable_fast - Video2 快速模型
  • videos_pro - Seedance 标准模型
  • videos_pro_fast - Seedance 快速模型
promptbodystring必填
视频生成提示词。videos_stable / videos_stable_fast / videos_pro / videos_pro_fast 最大 5000 个字符；videos 不限制为 5000 字符。
建议避免违规、侵权、涉政、涉黄等高风险内容。
示例："一只可爱的小猫在草地上玩耍"
durationbodyinteger必填
视频时长（秒）。videos / videos_stable 支持 4-15 秒；videos_stable_fast / videos_pro / videos_pro_fast 仅支持 10 或 15 秒。
ratiobodystring
输出比例，默认 16:9。
支持的值：
  • videos：21:9、16:9、4:3、1:1、3:4、9:16
  • videos_stable / videos_stable_fast / videos_pro / videos_pro_fast：16:9、9:16、1:1
resolutionbodystring
输出分辨率，默认 720p。
当前仅支持：
  • 720p

首尾帧模式

first_imagebodystring
首帧图片 URL。
  • 仅用于首尾帧场景
  • 必须搭配 last_image 使用
不能与 referenceImages 或 referenceVideos 同时使用；首尾帧模式不支持 referenceAudios
last_imagebodystring
尾帧图片 URL。
  • 必须搭配 first_image 使用
不能与 referenceImages 或 referenceVideos 同时使用；首尾帧模式不支持 referenceAudios
兼容说明：
  • 历史字段 image 和 lastFrameImage 仍可继续使用
  • 同时传新旧字段时，优先按 first_image / last_image 处理
  • 同时传新旧字段且值不一致时，接口会返回参数冲突

引用素材模式

referenceImagesbodyarray
参考图片 URL 列表。
规则说明：
  • videos / videos_pro / videos_pro_fast 最多 9 张
  • videos_stable / videos_stable_fast 最多 4 张
  • 每张图片不能超过 20MB
  • 可与 referenceVideos 组合形成图/视频混合参考
  • 可与 referenceAudios 组合；videos / videos_pro / videos_pro_fast 最多 3 段，videos_stable / videos_stable_fast 最多 1 段
  • videos_pro / videos_pro_fast 的音频参考不能作为唯一参考输入，必须搭配 referenceImages
不能与 image 或 lastFrameImage 同时使用
referenceVideosbodyarray
参考视频 URL 列表。
规则说明：
  • videos / videos_stable / videos_stable_fast 最多 3 个
  • videos_pro / videos_pro_fast 不支持参考视频
  • 总时长不能超过 15 秒
  • 总大小不能超过 200MB
  • 单个参考视频分辨率需在 720px-2160px 之间
不能与 image 或 lastFrameImage 同时使用
referenceAudiosbodyarray
参考音频 URL 列表。
规则说明：
  • videos 最多支持 3 段
  • videos_stable / videos_stable_fast 最多支持 1 段
  • videos_pro / videos_pro_fast 最多支持 3 段
  • 总时长不能超过 15 秒
  • 用于为视频生成提供音频风格、节奏或声音参考
  • 可与 referenceImages 组合形成音频参考；referenceVideos 仅适用于支持视频参考的模型
  • videos_pro / videos_pro_fast 的音频参考不能作为唯一参考输入，必须搭配 referenceImages
超过当前模型支持的音频数量会直接报错；首尾帧模式不支持音频参考。videos_pro / videos_pro_fast 的音频参考不能作为唯一参考输入。
autoFacebodyboolean
是否为本次任务请求自动人脸处理，默认 false。
仅 videos 模型生效，其他模型传递时不生效

响应参数

idstring
视频生成任务的唯一标识符，用于后续查询任务状态。
objectstring
对象类型，固定为 video。
createdinteger
任务创建时间戳。
modelstring
使用的模型名称。
statusstring
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
errorstring
错误信息，当状态为 failed 时返回。

参数选择规则

互斥规则：
  • 首尾帧模式：first_image 和 last_image 必须成对使用
  • 引用素材模式：referenceImages、referenceVideos 可按模型能力单独或组合使用；referenceAudios 在 videos / videos_pro / videos_pro_fast 下最多 3 段，在 videos_stable / videos_stable_fast 下最多 1 段。videos_pro / videos_pro_fast 不支持视频参考，音频参考必须搭配图片参考
  • 模式互斥：首尾帧模式不能与引用素材模式或音频参考同时使用

使用场景

纯文生视频

仅传 prompt、model、duration 等基础参数

首尾帧视频

通过 first_image 和 last_image 精确控制开头与结尾画面

多模态混合参考

通过 referenceImages、referenceVideos 与 referenceAudios 组合提供更强的素材约束

模型特性

模型计费方式时长范围素材能力支持比例
videos按次计费4-15 秒最多 9 张图、3 个视频、3 段音频21:9、16:9、4:3、1:1、3:4、9:16
videos_stable按次计费4-15 秒最多 4 张图、3 个视频、1 段音频16:9、9:16、1:1
videos_stable_fast按次计费10 秒、15 秒最多 4 张图、3 个视频、1 段音频16:9、9:16、1:1
videos_pro按次计费10 秒、15 秒最多 9 张图、3 段音频，不支持视频参考；音频必须搭配图片参考16:9、9:16、1:1
videos_pro_fast按次计费10 秒、15 秒最多 9 张图、3 段音频，不支持视频参考；音频必须搭配图片参考16:9、9:16、1:1
最佳实践：
  1. 视频生成为异步处理，请保存创建返回的 id 用于后续查询。
  2. 提示词尽量包含具体场景、动作、镜头和风格描述。
  3. 使用首尾帧模式时，确保两张图片在风格和构图上连续。
  4. 使用视频或音频参考时，优先提供清晰、时长较短、主体明确的素材。
  5. 如果需要 Video2 快速模型，请使用 videos_stable_fast；如果需要 Seedance 快速模型，请使用 videos_pro_fast。
提示词建议：
  • 描述主体、动作和镜头语言
  • 补充风格词，如“电影感”“写实”“梦幻”
  • 如果有运动轨迹诉求，可直接写明镜头推进、转场或视角变化