mingyan

Videos - 创建任务

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

POST/kyyReactApiServer/v1/videos/videos

Videos 创建视频任务

使用 Videos 系列模型创建视频生成任务，支持 videos、videos_stable 和 videos_stable_fast。接口支持纯文生、首尾帧、多图参考、视频参考和音频参考；其中 videos 最多支持 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 标准模型，按次计费，支持更多画幅和音频参考
videos_stable：Video2 满血模型，按次计费
videos_stable_fast：Video2 快速模型，按次计费

请求参数

modelbodystring必填

模型名称。

可选值：

videos - Videos 标准模型，支持音频参考
videos_stable - Video2 满血模型
videos_stable_fast - Video2 快速模型

promptbodystring必填

视频生成提示词。videos_stable / videos_stable_fast 最大 5000 个字符；videos 不限制为 5000 字符。

建议避免违规、侵权、涉政、涉黄等高风险内容。

示例："一只可爱的小猫在草地上玩耍"

durationbodyinteger必填

视频时长（秒），范围 4-15 秒。

ratiobodystring

输出比例，默认 16:9。

支持的值：

videos：21:9、16:9、4:3、1:1、3:4、9:16
videos_stable / videos_stable_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 最多 9 张
videos_stable / videos_stable_fast 最多 4 张
每张图片不能超过 20MB
可与 referenceVideos 组合形成图/视频混合参考
可与 referenceAudios 组合；videos 最多 3 段，videos_stable / videos_stable_fast 最多 1 段

不能与 image 或 lastFrameImage 同时使用

referenceVideosbodyarray

参考视频 URL 列表。

规则说明：

最多 3 个
总时长不能超过 15 秒
总大小不能超过 200MB
单个参考视频分辨率需在 720px-2160px 之间

不能与 image 或 lastFrameImage 同时使用

referenceAudiosbodyarray

参考音频 URL 列表。

规则说明：

videos 最多支持 3 段
videos_stable / videos_stable_fast 最多支持 1 段
总时长不能超过 15 秒
用于为视频生成提供音频风格、节奏或声音参考
可与 referenceImages、referenceVideos 组合形成多模态混合参考

超过当前模型支持的音频数量会直接报错；首尾帧模式不支持音频参考

响应参数

idstring

视频生成任务的唯一标识符，用于后续查询任务状态。

objectstring

对象类型，固定为 video。

createdinteger

任务创建时间戳。

modelstring

使用的模型名称。

statusstring

任务状态：

queued - 排队中
processing - 处理中
completed - 已完成
failed - 失败

errorstring

错误信息，当状态为 failed 时返回。

参数选择规则

互斥规则：

首尾帧模式：first_image 和 last_image 必须成对使用
引用素材模式：referenceImages、referenceVideos 可单独或组合使用；referenceAudios 在 videos 下最多 3 段，在 videos_stable / videos_stable_fast 下最多 1 段
模式互斥：首尾帧模式不能与引用素材模式或音频参考同时使用

使用场景

纯文生视频

仅传 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`	按次计费	4-15 秒	最多 4 张图、3 个视频、1 段音频	`16:9`、`9:16`、`1:1`

最佳实践：

视频生成为异步处理，请保存创建返回的 id 用于后续查询。
提示词尽量包含具体场景、动作、镜头和风格描述。
使用首尾帧模式时，确保两张图片在风格和构图上连续。
使用视频或音频参考时，优先提供清晰、时长较短、主体明确的素材。
如果需要 Video2 快速模型，请使用 videos_stable_fast。

提示词建议：

描述主体、动作和镜头语言
补充风格词，如“电影感”“写实”“梦幻”
如果有运动轨迹诉求，可直接写明镜头推进、转场或视角变化