mingyanmingyan
mingyan

Omni Flash - 创建任务

使用 Omni Flash 创建视频生成任务,支持文生视频、首帧、首尾帧、多参考图和参考视频

POST/kyyReactApiServer/v1/omni-flash/videos

Omni Flash 创建视频任务

使用 omni-flash 创建视频生成任务。对外统一使用一个模型名,系统会根据是否传入 input_video 自动选择对应的生成能力。

认证

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

基础 URL

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

请求参数

modelbodystring必填
模型名称,固定为 omni-flash
promptbodystring必填
视频生成提示词,描述画面主体、动作、镜头、风格和约束。
示例:"她们在舞台上跳舞唱歌,镜头缓慢推进,电影感光线"
secondsbodystring
视频时长,单位为秒。
  • 默认值:10
  • 当前仅支持:10
aspect_ratiobodystring
输出画面比例。
  • 默认值:16:9
  • 可选值:16:99:16
resolutionbodystring
输出分辨率。
  • 默认值:720p
  • 可选值:720p
input_videobodystring
参考视频 URL。传入后进入参考视频生成模式。
仅支持公网 URL,不支持 data:video/...;base64,...
first_image_urlbodystring
首帧图片公网 URL。可单独用于首帧图生视频,也可与 last_image_url 搭配用于首尾帧模式。不能与 imagesreferenceImages 同时使用。
last_image_urlbodystring
尾帧图片公网 URL。必须搭配 first_image_url 使用,不能单独传。不能与 imagesreferenceImages 同时使用。
imagesbodyarray
参考图片公网 URL 列表。不能与 first_image_urllast_image_url 同时使用。

兼容字段

以下旧字段仍可兼容读取,但新接入建议优先使用上面的官方风格字段:
  • duration:等同于 seconds
  • ratio:等同于 aspect_ratio
  • referenceImages:等同于 images

能力模式

文本生成视频

仅传 modelpromptsecondsaspect_ratioresolution

首帧/首尾帧

使用 first_image_url,或同时使用 first_image_urllast_image_url

多参考图

使用 images 提供参考图片,约束人物、风格或画面元素。

参考视频

使用 input_video 提供参考视频,系统自动进入参考视频生成模式。

参数约束

关键约束:
  • model 仅支持 omni-flash
  • seconds 当前仅支持 10
  • resolution 仅支持 720p
  • aspect_ratio 仅支持 16:99:16
  • input_video 不支持 base64
  • last_image_url 必须搭配 first_image_url 使用
  • images / referenceImages 不能与 first_image_url / last_image_url 同时使用
  • input_video 与图片字段是否可以组合由上游判断,服务端不做强拦截

素材与内容限制

类别项目规范说明
参数视频时长参考视频最佳输入时长为 8-10 秒;若超过 10 秒,上游可能仅截取前 10 秒处理。
参数素材容量单次任务仅支持 1 段参考视频,辅助图片最多 5 张,建议控制在 3 张以内。
参数输出时长参考视频模式下,生成视频时长通常等于上传参考视频时长,例如上传 8 秒参考视频则生成约 8 秒视频。当前接口参数 seconds 仍固定为 10
禁止侵权元素禁止使用受版权保护的元素。
禁止知名 IP / 角色禁止使用知名 IP、动漫角色、影视角色。
禁止真实名人肖像禁止使用真实名人肖像。
禁止品牌标识禁止使用知名品牌 Logo、标志性服饰或道具。
禁止受保护音频禁止使用受保护的背景音乐、歌曲或特定角色配音。
禁止内容审核禁止包含擦边、暴力、敏感等违规信息。
禁止语言与识别不支持方言识别,建议使用标准普通话、英语或其他清晰语种。
建议素材原创性建议使用自有版权的原创素材,或已获得授权的无版权素材。
建议提示词撰写避免在提示词中提及具体 IP、名人、品牌;避免使用“做成类似 XX 角色”等近似复制指令;推荐以原创虚构人物和场景为核心描述。
注意文件大小视频文件建议严格控制在 15MB 以内,图片同样建议控制在 15MB 以内。

响应参数

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