Gemini 2.5 Pro 与 Flash 弃用：12 月 1 日 API 切换与迁移要点
更新日期：2026年11月04日。新闻条目日期为 2026年11月02日，文中所述 API 自动路由计划于 2026年12月01日生效。
Gemini 2.5 弃用进入了需要开发者安排迁移的阶段。据 AIHOT 收录的 Gemini API 更新日志，Google AI Studio 已不再提供 Gemini 2.5 Pro 与 Gemini 2.5 Flash 的模型选择；从 2026 年 12 月 1 日起，发往这两个旧模型 ID 的 API 请求将分别转向指定的新模型，并按目标模型费率计费。
这则消息对现有应用的影响，集中在三个问题：请求最终由哪个模型处理，旧参数还能不能使用，以及切换后的费用如何计算。自动路由提供了旧模型名称的承接路径，但应用仍需要验证请求格式、工具调用和输出结果。
来源与核验范围
本文已核对用户提供的 AIHOT 新闻及其英文原文视图。AIHOT 将来源标注为 Google 的 Gemini API 更新日志；本次写作未能直接加载该官方页面，因此下文将具体安排归因于这份收录内容，不视为额外获得的官方确认。上线前请从文末的官方更新日志、弃用说明与迁移指南再次核对。本文不补充未经核验的具体单价或参数取值。
一、Gemini 2.5 弃用时间：先退出 AI Studio，再切换 API 路由
新闻提到的两个时间点，需要分开理解。
| 时间 | 收录内容描述的变化 | 对使用者的影响 |
|---|---|---|
| 2026 年 11 月 2 日的更新条目 | Gemini 2.5 Pro 与 2.5 Flash 已弃用，无法在 Google AI Studio 中选择 | 在 AI Studio 进行交互测试时，需要选择仍可用的模型 |
| 2026 年 12 月 1 日起 | 发往两个旧模型 ID 的 API 请求自动路由至指定目标，按目标模型费率计费 | 已部署应用需要提前检查模型配置、兼容性与成本 |
截至本文更新日 2026 年 11 月 4 日，12 月 1 日仍是未来日期。因此，这条新闻不能写成“所有旧 API 请求现在已经完成切换”，也不能据此断言两个旧模型 ID 会在当天直接返回停服错误。报道描述的是一项有明确生效日期的自动路由安排。
时间线依据 AIHOT 收录内容绘制，为本站示意图。
还需要注意消息的适用范围。本文讨论 Google AI Studio 和该条 Gemini API 更新日志涉及的模型请求，不据此推断 Gemini 消费者应用中的订阅权益，也不把同一时间表直接套用到 Vertex AI 或第三方平台。
二、Gemini 2.5 弃用后的两条迁移路径
收录的英文正文给出了明确的对应关系：
| 现有模型 ID | 12 月 1 日起计划路由至 | 切换后的计费依据 |
|---|---|---|
gemini-2.5-pro | gemini-3.8-flash | Gemini 3.8 Flash 费率 |
gemini-2.5-flash | gemini-3.5-flash-lite | Gemini 3.5 Flash-Lite 费率 |
其中容易看漏的是：**2.5 Pro 与 2.5 Flash 并不迁移到同一个目标。**不能只按 Pro、Flash、Lite 的名称习惯推测替代关系，应以弃用条目列出的映射为准。
图中为新闻所述的默认路由对应关系，不代表性能、价格或能力等价。
对应用维护者而言，建议在截止日期前显式更新模型配置，并记录实际采用的目标型号。这样可以把变更安排在团队可测试、可观察的时间窗口内，而不是等路由规则生效后再排查行为差异。
如果应用原本依赖 2.5 Pro 完成复杂分析，默认承接模型是否符合要求，还需要用原有业务样本判断。模型名称和请求能否成功，都不能代替质量评估；该路由安排本身也没有提供业务效果相同的保证。
三、API 兼容性：改模型名称只是第一步
AIHOT 收录正文对两条迁移路径列出了相同的破坏性变更类别：函数调用与 thought_signature 校验、thinking_level 替代 thinking_budget，以及移除采样参数和预填充模型轮次。新闻没有展开所有字段的规则，因此以下是迁移检查方向，具体实现仍以目标模型指南为准。
函数调用与思考签名
如果系统让模型调用外部工具，检查范围需要覆盖完整的一轮交互：模型提出调用、应用执行工具、工具结果回传，以及模型继续回答。只测试一次纯文本问答，无法判断这条链路是否兼容。
对自行保存和重建对话历史的系统，尤其要检查是否丢弃了响应中的结构化字段。thought_signature 是本次正文明确提到的校验项；应用不应在不了解协议要求的情况下，仅保存可见文字、手工拼回历史并假设行为一致。
思考配置从 budget 转向 level
旧项目若使用 thinking_budget 控制思考配置，需要对照新模型检查 thinking_level 的写法。两者名称表达的配置方式不同，不能简单把原有数值搬到新字段，也不能自行编造可选档位。
迁移时应确认使用中的 SDK、网关和配置层能正确传递新字段，然后分别测试常见任务与复杂任务的质量和延迟。
采样参数与预填充对话
新闻说明有采样参数被移除，但未在条目中逐一列出。不要据此猜测某个参数一定可用或一定被删除；应把当前请求携带的字段与目标模型指南逐项对照。
“预填充模型轮次”可以理解为应用预先放入一段模型回答开头，让模型接着生成。若项目依赖这种方法固定输出格式，应重新验证替代方案；需要结构化结果的场景，还应检查目标模型所支持的结构化输出方式及业务侧校验。
四、计费变化：旧模型名称不再代表旧价格
这次消息明确提到，自动路由后的请求按目标模型费率计费。因此，继续在配置中保留 gemini-2.5-pro 或 gemini-2.5-flash，不能作为维持旧价格的依据。
本文不列具体美元单价，因为本次未能直接核验官方价格页。判断费用是上升还是下降，需要同时比较目标型号的适用费率、实际输入输出用量，以及应用是否产生更多重试或工具交互。仅凭 Flash 或 Lite 的名称无法得出成本结论。
建议为迁移准备同一批业务样本，记录每个任务的完成情况、输入输出用量、耗时和可归属的费用。预算评估以“完成一个合格任务花多少钱”为单位，比只比较一次请求的价格更接近真实使用情况。
五、开发者应在截止日前完成哪些检查？
可以按下面的顺序推进，把模型切换变成一次可验证的应用更新。
- 盘点旧模型引用。 搜索代码、环境变量、后台配置、批处理任务和备用路由中的两个旧模型 ID，明确哪些服务受影响。
- 核对目标文档。 先确认官方弃用条目仍采用上述时间与映射，再核对 SDK、参数和模型可用范围。
- 更新配置与请求结构。 同步处理模型名称、思考字段、工具调用历史和已移除参数，避免只替换一个字符串。
- 执行业务回归。 至少覆盖普通问答、多轮对话、函数调用和格式严格的输出；根据实际功能加入长文档等测试。
- 灰度观察再扩大流量。 比较失败率、任务质量、耗时和费用，准备回退至经验证且仍受支持的配置。不要把旧模型 ID 当作截止日期后的独立回退方案。
迁移流程为本文的工程建议，非 Google 官方操作界面。
如果系统使用自建代理或第三方网关，还应检查其是否改写模型名、过滤请求字段或重建消息历史。这里需要验证的是整条调用链，而不只是应用代码中最外层的配置。
六、常见问题
Gemini 2.5 Pro 和 Flash 的 API 现在就不能用了吗？
不能从这条消息得出这个结论。收录内容说的是 AI Studio 已无法选择这两个模型，以及 API 计划从 2026 年 12 月 1 日起自动路由。实际请求状态仍需要结合官方文档和项目环境确认。
自动路由是否意味着可以完全不用改代码？
不能这样理解。条目同时提醒存在破坏性 API 变更。即使旧模型名称得到承接，参数、工具交互和对话历史处理仍需要测试。
Gemini 2.5 Flash 也会切换到 Gemini 3.8 Flash 吗？
按这份收录内容，不会。gemini-2.5-flash 的计划承接型号是 gemini-3.5-flash-lite；gemini-3.8-flash 对应的是 gemini-2.5-pro。
迁移后一定更便宜或更强吗？
这条新闻没有提供足以支持此结论的价格对比和业务评测。费用与效果都应使用目标模型的实际配置和业务样本验证。
七、把 Gemini 2.5 弃用当作一次应用迁移
Gemini 2.5 弃用带来的直接任务，是在 2026 年 12 月 1 日之前核对迁移安排，明确两条目标路径，检查请求协议，并重新评估业务质量和费用。对于仍在维护旧项目的团队，先找出哪些服务引用旧模型，再安排回归测试，是现在就能推进的工作。
自动路由安排可以承接旧名称，但应用的稳定性最终仍要由实际测试说明。建议收藏官方弃用页与迁移文档，在变更上线前再次核对；
八、新闻与参考资料
- Gemini API 官方更新日志：2026 年 11 月 2 日条目：AIHOT 标注的原始来源，本次未能直接加载。
- 官方弃用说明：上线前核对时间表与受影响模型。
- Gemini 3.8 Flash 迁移指南：新闻所附的 Pro 迁移参考。
- Gemini 3.5 Flash-Lite 迁移指南：保留新闻所附原始地址，其路径中的版本号与目标模型名称不同，请打开后确认对应章节。
- Gemini API 定价页：核对目标模型费率，本文未直接核验具体价格。
本文为独立中文资讯整理与迁移分析，非 Google 官方公告；迁移流程属于工程建议。模型可用性、参数、价格及生效安排若有调整，以 Google 官方页面和账户实际显示为准。