本文要点
- Gemini API 于 2026 年 8 月 27 日发布 gemini-omni-1.1-flash GA，官方推荐它替代 gemini-omni-flash-preview。
- 官方 changelog 写旧 endpoint 将于 9 月 30 日 deprecated，deprecations 表将同日列为 shutdown date；应按不可继续调用准备。
- 1.1 新增视频延长、首尾帧插值和 360p、720p、1080p、4k 分辨率控制，但迁移不能只验证一次文本到视频。
- 要回归请求 schema、异步任务状态、输出下载、质量、延迟、费用和失败重试。
- 在新链路完整通过前保留旧路径与回滚开关；不要等到截止日才首次批量切换。
发生了什么：两个官方页面的措辞如何理解
Gemini API release notes 将 gemini-omni-1.1-flash 标为 GA，并写 gemini-omni-flash-preview 将在 2026 年 9 月 30 日 deprecated。官方 deprecations 表把同一日期列为旧模型的 shutdown date，推荐替代为 1.1。为避免服务中断，工程上应按 9 月 30 日前完成迁移，而不是依赖措辞差异继续拖延。
常见症状会是旧模型不可选、model not found、异步任务无法启动或第三方平台仍硬编码 preview。错误直觉是盲目重试或换网络；第一步应从请求日志确认实际 model 字段和调用入口。
旧模型与新模型怎么对应
旧模型 ID 是 gemini-omni-flash-preview，新模型 ID 是 gemini-omni-1.1-flash。先在应用代码、环境变量、模型路由、低代码连接器、Batch 文件、定时任务和数据库配置中搜索旧字符串，并标注每个调用者的负责人和流量。
不要把 latest 别名、AI Studio 选择器和 API 固定 ID 混成一项。上线验收应记录请求中真正发送的模型，以及响应或任务对象返回的实际模型信息。
1.1 GA 新能力不是自动兼容证明
官方列出三项新增能力：extend 任务或提示驱动的视频延长、最多两张图的首尾帧插值，以及 video_config.resolution 对 360p、720p、1080p 和 4k 的支持。720p 是默认值，1080p 与 4k 通过上采样生成。
这些能力说明新模型的功能范围，不代表旧请求与输出字节一致。依赖固定尺寸、时长、帧首尾、任务状态或供应商封装的系统必须逐项回归，不能用一次成功响应代表迁移完成。
从清点到灰度的七步迁移
按顺序执行：冻结新增旧模型配置；导出调用者清单；固定代表性输入与期望；在测试环境换成 1.1；验证生成、编辑、轮询、取消和下载；小比例灰度；最后更新默认路由与无人值守任务。每一步保存 request ID、状态、延迟、用量、费用和产物。
同时检查 SDK、第三方网关和内部模型白名单是否认识新 ID。若上游支持而中间层仍拒绝，不要把中间层 schema 错误误判成 Gemini 服务故障。
视频质量、分辨率与费用怎么验收
至少覆盖文本生成、单图动画、对话式编辑、extend、首尾帧插值和不同 resolution。对比构图稳定性、文字、人物连续性、时长、分辨率、处理时间、失败率和每个成功产物的费用。
4k 与 1080p 是上采样输出，不能仅凭像素尺寸声称细节等同原生高分辨率。价格、配额和区域以当前模型页、项目限制和账单为准；本页不推算未公开的单任务成本。
错误分层与网络边界
model not found、字段不兼容和不支持的任务属于模型或 schema；429 属于配额；5xx 需要保存 request ID 并按官方重试建议处理；只有连接超时、DNS、TLS 或代理认证有证据时才查网络。旧模型截止不会因为换出口而恢复。
先参考<a href="/resources/gemini-api-429-503-rate-limit-guide">Gemini 429/503 排查指南</a>与<a href="/resources/ai-api-key-base-url-model-guide">AI API 配置指南</a>分层，再决定是否重试、降级或升级支持。
停手、回滚与截止日前复查
如果新模型在关键任务上质量回退、费用或延迟超标、异步状态无法兼容、产物下载丢失，或供应商封装尚不支持新 ID，应停止扩大流量。回滚只能是临时措施，且必须在 9 月 30 日前解决替代路径。
在截止前 14 天、7 天和 24 小时再次搜索旧模型调用量，确认零生产流量、零后台任务和零未归属配置。若仍有未知调用者，不要删除监控或旧配置记录，先限制影响并指定人工接管。
资料来源
常见问题
gemini-omni-flash-preview 什么时候停止使用？
官方 deprecations 表将 2026 年 9 月 30 日列为 shutdown date；release notes 同时使用 deprecated 措辞。应在该日期前完成迁移。
推荐替代模型 ID 是什么？
官方推荐 gemini-omni-1.1-flash，它是 2026 年 8 月 27 日发布的 GA 版本。
只替换 model 字符串就够了吗？
不够。还要回归生成、编辑、异步轮询、取消、下载、分辨率、质量、延迟、费用和第三方封装。
1.1 支持哪些分辨率？
官方列出 360p、720p、1080p 和 4k；720p 为默认，1080p 与 4k 通过上采样生成。
旧模型报 model not found 是网络问题吗？
通常先检查模型 ID、截止状态和中间层白名单。只有 DNS、TLS、连接超时等证据出现时才进入网络排查。
迁移失败时可以一直回滚到 Preview 吗？
不可以把它当长期方案。回滚仅用于短期止损，必须在官方截止前完成新模型或其他受支持路径的验收。