gemini-omni-1.2-flash 生成带声音的 MP4。支持文生视频、首帧图生视频、首尾帧和 1 到 3 张参考图。720P 或 1080P,时长 3 到 15 秒。
提交会等到视频生成完才返回。客户端超时设到 900 秒以上。价格见控制台「模型与价格」。
请求参数
不需要传
mode。传了哪种素材就是哪种用法。
成片时长等于请求的秒数,1080P 可能短零点几秒。
文生视频
图生视频
图片不接受网址。传https:// 会返回 400,不创建任务。用 data:image/...;base64,...,或用 multipart 上传文件。支持 PNG、JPEG、WebP,data: 里的类型必须和文件一致。提示词和图片合计不超过 15 MB,大图用 multipart。
Content-Type:
-F last_frame=@last.png。reference_images 可以重复传多个文件。首帧和尾帧必须同一种传法,参考图也不能混用 data URL 和文件。
不支持
- 参考视频。
- 首帧和参考图一起传。尾帧单独传,或尾帧和参考图一起传。
- 续写(
extend)、4K、360P。
查询
创建返回的status 通常已经是 completed。不是 completed 或 failed 时,每 10 秒查一次。
下载
返回video/mp4 本身,不是 JSON。支持 Range。
Task is not completed yet, current status: NOT_START。等几秒用同一个 id 再下,不要重新提交。
错误
参数错误返回 HTTP 400,不创建任务。JSON 里的seconds 必须是字符串:
401 是密钥无效。403 是额度不足。404
model_not_found 是当前分组没开通。高峰可能直接 5xx。failed 常见原因是内容不合规,改提示词或素材后再提交。排查时带上响应里的 request id 或任务 id。