mingyan
Omni Flash - 创建任务
使用 Omni Flash 创建视频生成任务,支持文生视频、首帧、首尾帧、多参考图和参考视频
Omni Flash 创建视频任务
使用
omni-flash 创建视频生成任务。对外统一使用一个模型名,系统会根据是否传入 input_video 自动选择对应的生成能力。认证
认证
获取 Key所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelbodystring必填模型名称,固定为
omni-flash。promptbodystring必填视频生成提示词,描述画面主体、动作、镜头、风格和约束。
示例:
"她们在舞台上跳舞唱歌,镜头缓慢推进,电影感光线"secondsbodystring视频时长,单位为秒。
- 默认值:
10 - 当前仅支持:
10
aspect_ratiobodystring输出画面比例。
- 默认值:
16:9 - 可选值:
16:9、9:16
resolutionbodystring输出分辨率。
- 默认值:
720p - 可选值:
720p
input_videobodystring参考视频 URL。传入后进入参考视频生成模式。
仅支持公网 URL,不支持
data:video/...;base64,...。first_image_urlbodystring首帧图片公网 URL。可单独用于首帧图生视频,也可与
last_image_url 搭配用于首尾帧模式。不能与 images 或 referenceImages 同时使用。last_image_urlbodystring尾帧图片公网 URL。必须搭配
first_image_url 使用,不能单独传。不能与 images 或 referenceImages 同时使用。imagesbodyarray参考图片公网 URL 列表。不能与
first_image_url 或 last_image_url 同时使用。兼容字段
以下旧字段仍可兼容读取,但新接入建议优先使用上面的官方风格字段:
duration:等同于secondsratio:等同于aspect_ratioreferenceImages:等同于images
能力模式
文本生成视频
仅传
model、prompt、seconds、aspect_ratio 和 resolution。首帧/首尾帧
使用
first_image_url,或同时使用 first_image_url 与 last_image_url。多参考图
使用
images 提供参考图片,约束人物、风格或画面元素。参考视频
使用
input_video 提供参考视频,系统自动进入参考视频生成模式。参数约束
关键约束:
model仅支持omni-flashseconds当前仅支持10resolution仅支持720paspect_ratio仅支持16:9、9:16input_video不支持 base64last_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 时返回。
