Gemini API 废弃 Gemini 2.5 Pro 和 2.5 Flash：12 月 1 日起请求自动改路由到 3.8 Flash 和 3.5 Flash-Lite，并按新模型计费

核心背景与行业痛点

很多生产应用至今仍把 gemini-2.5-pro 或 gemini-2.5-flash 写死在代码里。Google 11 月 2 日在 Gemini API 官方更新日志中宣布废弃这两个模型，它们已从 Google AI Studio 选择器下架。这次没有直接关停，而是 12 月 1 日起把旧模型名的请求自动转给新模型。好处是调用不会突然报错，风险是同一个模型名背后换了模型、换了价格，行为也可能变化。X 用户 Kerem（@mkeremturhan）等开发者在 X 上提醒了这一点。

架构亮点与底层机制

官方路由规则：gemini-2.5-pro 转到 gemini-3.8-flash，gemini-2.5-flash 转到 gemini-3.5-flash-lite，均按新模型价格计费。新模型属于 Gemini 3 系 API，破坏性变化包括函数调用与 thought_signature 校验、thinking_level 取代 thinking_budget、移除采样参数和预填模型回合。

权威 Benchmark 与实测跑分对比

这次是废弃公告，官方未公布 2.5 系与替代模型的对照跑分。价格按官方价目表：2.5 Pro 每百万 token 输入 $1.25、输出 $10.00；3.8 Flash 年底前推广价 $0.75 / $3.75，2027 年起 $1.50 / $7.50。2.5 Flash 与 3.5 Flash-Lite 文本价同为 $0.30 / $2.50。

开发者实战落地与开箱指南

建议 12 月 1 日前主动把模型字符串改成 gemini-3.8-flash 或 gemini-3.5-flash-lite，并按迁移指南改参数：thinking_budget 改为 thinking_level（low/medium/high），删除 temperature、top_p、top_k 和 candidate_count，多轮对话改用服务端 previous_interaction_id，FunctionResponse 带上 call_id 和 name。上线前重点回归多轮工具调用和输出质量。