Gemini 2.5 Pro / Flash 12 月迁移：自动路由、API 参数与成本
核对 Gemini 2.5 Pro 与 Flash 的 12 月自动路由安排，区分 Flash-Lite，列出参数检查项与目标模型费用算例，说明中转映射仍需单独核实。
核验日期：2026 年 11 月 3 日。本文依据 Google 当日可读的官方文档整理，没有调用 API 实测，也没有测试任何中转商家。
如果应用仍在请求 gemini-2.5-pro 或 gemini-2.5-flash，应在 12 月前安排迁移检查。Google 11 月 2 日公告已说明：旧 ID 将自动转到另一模型，费用也随目标模型计算。请求还能发送，不代表原有参数与输出行为可以直接沿用。
哪两个 ID 会改变
| 当前 ID | 2026 年 12 月 1 日起的目标 |
|---|---|
| gemini-2.5-pro | gemini-3.8-flash |
| gemini-2.5-flash | gemini-3.5-flash-lite |
两者已不能在 Google AI Studio 中选择。官方弃用页还说明，2.5 系列的 API 访问限于此前实际使用过的用户；其中 gemini-2.5-flash-lite 未被弃用，继续通过 API 提供，另行通知前没有停用日期。不要把 Flash、Flash-Lite、Flash Image 或 Preview 的安排混在一起。
这里讨论的是 Google Gemini API。不能由此推断某一家中转的旧名称已经映射到同一目标，也不能套用为 Gemini 消费者会员权益变化。
来源：11 月 2 日更新、官方弃用安排。
迁移前检查参数，而不只替换名称
Google 的迁移文档列出这些检查项：
- 将目标模型 ID 显式改成计划使用的新 ID。
- 由
thinking_budget转为thinking_level。3.8 Flash 支持 low、medium、high，默认 medium，不支持 minimal。 - 3.5 Flash-Lite 默认 minimal。官方建议多步推理或工具子代理场景考虑 medium 或 high；这不是对具体业务效果的保证。
- 检查 temperature、top_p、top_k、candidate_count 和末尾预填 model turn。迁移文档要求移除这些旧写法。
- 多轮工具调用要检查 thought signature 的保留。使用 generateContent 时，还要核对 FunctionResponse 的 call_id 与 name。
不同接口的会话写法不能混用。官方 3.8 指南对 Interactions 推荐 previous_interaction_id；如果项目仍用 generateContent，应按该接口的原始文档逐项核查，而不是直接把字段抄过去。
建议先选一小组不含私人数据、答案可判定的既有样例，分别覆盖普通文本、结构化输出、多轮和工具调用。记录错误、结果差异及实际计费 Token；关键字段丢失、工具链中断或成本超出预算时，先修正兼容问题，再扩大迁移范围。本文未执行这组测试。
来源：3.8 Flash 迁移清单、3.5 Flash-Lite 迁移清单。
目标模型费用：12 月与次年预算分开
以下是官方付费 Standard 档、每百万 Token 的美元价格。输出计费含思考 Token。
| 目标模型与适用日期 | 输入 | 输出 |
|---|---|---|
| Gemini 3.8 Flash，至 2026-12-31 | $0.75 | $3.75 |
| Gemini 3.8 Flash，2027-01-01 起 | $1.50 | $7.50 |
| Gemini 3.5 Flash-Lite，核验日公布费率 | $0.30 | $2.50 |
算例假设：1,000 次调用，每次 2,000 个普通输入 Token、500 个总计费输出 Token；输出假设已包含任何计费思考 Token。合计输入 200 万、输出 50 万 Token。
- 3.8 Flash 在 12 月：2 × $0.75 + 0.5 × $3.75 = $3.375。
- 同样用量按 2027 年 1 月公布价格：2 × $1.50 + 0.5 × $7.50 = $6.75。
- 3.5 Flash-Lite：2 × $0.30 + 0.5 × $2.50 = $1.85。
这是用固定用量比较预算，不是实际请求账单或质量对比。未计算缓存、搜索等工具、重试、税费、汇率或商家加价，也没有把 Batch、Flex、Priority 或免费额度混入 Standard。实际迁移后，思考与输出长度可能变化，应重新测量用量。
来源：Google 官方定价。
通过中转购买时，先核四件事
- 展示的旧模型名实际对应哪个上游 ID，映射何时生效。
- 接口是哪种协议，是否保留工具调用与思考相关字段。
- 报价的币种、输入与输出单位，以及思考 Token 如何计费。
- 小规模验收的错误处理与账单是否符合公布规则。
这些是采购与接入检查建议，不代表任何商家已通过验证。仅凭名称相同、一次回答正确或页面写着“官方”，不足以确认来源与长期稳定性。
阅读范围
这是一份截至核验日的迁移说明，聚焦 2.5 Pro 与 2.5 Flash 的公告、目标模型计费和官方参数要求。没有运行 SDK、测评模型质量、代替用户迁移代码或保证兼容。未来费率及退役安排仍应以上述官方页面的新公告为准。