gemini-omni-1.2-flash 生成带声音的 MP4。支持文生视频、首帧图生视频、首尾帧和 1 到 3 张参考图。720P 或 1080P,时长 3 到 15 秒。 提交会等到视频生成完才返回。客户端超时设到 900 秒以上。价格见控制台「模型与价格」。

请求参数

不需要传 mode。传了哪种素材就是哪种用法。 成片时长等于请求的秒数,1080P 可能短零点几秒。

文生视频

720P 一般 50–80 秒返回,1080P 一般 90–130 秒。高峰更久。超时或 504 时任务可能已经创建,先查询再决定要不要重提。

图生视频

图片不接受网址。传 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。
创建响应刚到时,下载可能短暂返回 400,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。