模型解析页

Gemini Omni

Gemini Omni 是偏快速出片与低延迟反馈的视频模型，适合概念验证、社媒短视频、批量生成和高频提示词迭代。页面内容按 ToAPIs 的通用视频任务契约组织，方便先验证流程再迁移到生产调用。

厂商

Google

能力

Video

价格

Pay-as-you-go pricing

更新

在 Playground 中打开文档

模型概览

快速结论

定位偏 Flash，优先满足快速生成、低延迟反馈和高频迭代场景。
适合概念验证、社媒短视频和批量出片，不必一开始就走重制作流程。
使用异步视频任务接口，先提交任务，再通过状态接口轮询结果。

Gemini Omni模型特点

核心能力

能力一览与工程实践价值

低延迟出片

更适合需要快速看到结果并频繁调整提示词的工作流。

短视频批量生成

适合短时长内容、多版本测试和批量社媒素材生产。

统一视频任务契约

沿用 ToAPIs 通用视频任务接口，方便从验证迁移到生产接入。

如何使用 Gemini Omni API

设置 Authorization: Bearer <YOUR_API_KEY>。
提交包含 model、prompt、aspect_ratio、duration、resolution 的任务请求。
记录返回的 task_id，并通过视频任务状态接口轮询结果。
根据输出效果继续微调 prompt、画幅比例和时长等参数。

关键参数

参数	类型	必填	默认值	取值范围	说明
model	string	是	gemini_omni	-	模型标识，固定使用 `gemini_omni`。
prompt	string	是	-	-	描述目标视频的主体、动作、场景与风格。
aspect_ratio	string	否	16:9	16:9 \| 9:16	视频画幅比例，默认 `16:9`；分别对应横屏和竖屏。
duration	integer	否	6	6 \| 10	输出时长，单位秒；默认 `6`，当前仅支持 `6` 和 `10`。
resolution	string	否	720P	720P	输出分辨率，当前仅支持 `720P`；不传时按默认值处理。

常见错误

400 invalid_request_error

触发条件: 请求体缺少必填字段或字段类型不匹配。

修复建议: 校验 model、mode、input 的字段完整性与类型。

重试策略: 修正参数后重试，不建议直接盲重试。

401 authentication_error

触发条件: 缺少 Authorization 头或 API Key 无效。

修复建议: 确认 Bearer Token 与密钥权限范围。

重试策略: 修复鉴权后重试；连续失败请轮换密钥。

429 rate_limit_exceeded

触发条件: 请求频率、并发或当前额度命中上游限流策略。

修复建议: 先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。

重试策略: 建议指数退避（例如 1s/2s/4s）+ 抖动；连续触发时再收紧提交节奏。

500 internal_error

触发条件: 上游服务瞬时异常或内部处理失败。

修复建议: 记录 request id 并触发重试链路。

重试策略: 可短间隔重试 2-3 次，持续失败请升级人工排查。

FAQ

Gemini Omni 更适合什么场景？

更适合概念验证、社媒短视频、批量出片和需要低延迟反馈的高频创意迭代场景。

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

模式说明

Text to Video 模式（Gemini Omni）

从文字直接生成视频，适合快速脚本验证和短视频打样。

模式参数

modelpromptaspect_ratiodurationresolution

最佳应用场景

概念验证
脚本预演
社媒短视频打样