Gemini 2.5 Pro 弃用：12 月 1 日之后会变什么

2026 年 12 月 1 日，Google 会把每个 Gemini 2.5 Pro 请求转到 Gemini 3.8 Flash，并按 3.8 Flash 的价格计费：每百万输入 token $0.75，每百万输出 token $3.75，这个价格到 2026 年 12 月 31 日为止（Google 弃用页面，2026 年 11 月 4 日核对）。当天调用仍然成功。为旧模型写的请求体会失败，好在多数修复只改几行。

三处改动就能覆盖大部分工作：

• 把模型字符串换成 gemini-3.8-flash；
• 用 thinking_level 取代 thinking_budget；
• 删掉 temperature、top_p、top_k、candidate_count 和预填的 model 轮次。

另外三步处理多轮状态、函数调用和 SDK。每一步的后果写在下面，跳过的代价也一并列出。

12 月 1 日到底发生什么？

日期来自 Google 的版本更新记录，不是某个倒计时页面。标着 2026 年 11 月 2 日的那条把 gemini-2.5-pro 标为弃用，并写明所有 API 请求会自动转到 gemini-3.8-flash，按 Gemini 3.8 Flash 价格计费（Google 版本更新记录，2026 年 11 月 4 日核对）。

弃用表补上了前后的日期：2025 年 6 月 17 日发布，2026 年 12 月 1 日停止服务，替代模型是 gemini-3.8-flash（2026 年 11 月 4 日核对）。模型页的范围更窄：API 只对用过它的老用户开放，而且只到 2026 年 12 月 1 日。AI Studio 的模型选择器里已经找不到它。

有一处细节值得读两遍。同一行表格既把 2026 年 12 月 1 日写成停止服务日，又写明会自动转发到 3.8 Flash。转发后的响应里写 gemini-2.5-pro 还是 gemini-3.8-flash，Google 没有说明。第一天就把拿到的模型 ID 记进日志。

不管响应怎么写，替代模型本身是稳定的：gemini-3.8-flash 于 2026 年 9 月 2 日上线，只有一个稳定版本 ID，还没有公布停止服务日期（Google 弃用页面，2026 年 11 月 4 日核对）。

切换之后，代码和账单会怎样

老用户规则现在就已经生效。Google 的 2.5 Pro 模型页写着，API 只对主动用过它的老用户开放，且只到 2026 年 12 月 1 日（2026 年 11 月 4 日核对）。动手规划之前，先用团队真正部署的那个 key 测一次。

两个模型的接近程度超过这条规则给人的印象。输入都是 1,048,576 token，最多输出 65,536 token，都能读文字、图片、视频、音频和 PDF，都只返回文字（Google 模型页，2026 年 11 月 4 日核对）。差别在边缘功能上：3.8 Flash 的页面把 computer use 列为支持，2.5 Pro 的页面没有这一行。音频生成、图片生成和 Live API 在两边都标为不支持。

再看账单。12 月 1 日之后，同样的请求按 3.8 Flash 价格收费。在此之前，2.5 Pro 保持自己的价格，也保留 200,000 token 的分档。

换到 3.8 Flash 后哪些请求会出错

有六种请求写法会变，函数调用要最仔细地过一遍。Google 的 3.8 Flash 迁移清单逐条列出了这些变化（2026 年 11 月 4 日核对）。

采样参数是最安静的那个故障。Google 的 3.6 版本记录说 temperature、top_p、top_k 已弃用，现在被忽略，后续模型代际里带上它们会返回 HTTP 400（2026 年 11 月 4 日核对）。对调好的提示词来说，被忽略比被拒绝更糟：确定性设置悄悄失效，没有任何报错提醒你。

预填是声音最大的那个。最后一条非空轮次是 model 轮次的请求会返回 HTTP 400，解法是 system_instruction 或结构化输出（Google 3.6 版本记录，2026 年 11 月 4 日核对）。多轮对话应该带 previous_interaction_id，不要重新拼一份末尾预填的对话记录。

函数调用方面：把多模态素材放进响应体里，行内指令之间用 \n\n 分隔，预工具文字附近出现 Malformed_Function_Call 时按 Google 给的办法处理。走旧的 generateContent 调用时，每个 FunctionResponse 都要带 call_id 和 name。

思考签名是第六项，SDK 比模型旧的时候尤其要紧。Google 的清单把 SDK 升级和签名保留指到它自己的思考签名页面。

六步改完

按这个顺序做。前两步影响每个请求，后面几步只影响特定功能。

1. 改模型字符串。 把 gemini-2.5-pro 换成 gemini-3.8-flash，写在配置里，不要写进重试函数，这样日志里显示的就是你真正想调的 ID。
2. 换掉思考预算。 thinking_budget 改成 thinking_level，取值 low、medium 或 high。默认是 medium，minimal 会返回错误。
3. 删掉采样参数和预填轮次。 temperature、top_p、top_k、candidate_count 和结尾的 model 轮次一起删。
4. 迁移多轮状态。 统一用服务端的 previous_interaction_id。
5. 检查函数调用。 素材放进响应体，行内指令之间用 \n\n，每个 FunctionResponse 都带 call_id 和 name。
6. 升级 SDK，保留思考签名。 3.8 的清单位于 Google 的思考签名页面，升级和签名保存都写在那里。

请求的前后对比一屏就够。改前：

{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}

改后：

{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}

12 月 1 日之前，用 gemini-3.8-flash 跑一次真实请求，把响应里的模型 ID 记下来。

如果想在切换期换一种方式调用 gemini-3.8-flash，Gemini 3.8 Flash 模型页列了模型 ID、1M 上下文和三档思考等级。两个模型的当前费率在价格页。

价格差多少

在标准付费档，到 2026 年 12 月 31 日为止，3.8 Flash 的输出价格不到 2.5 Pro 的一半，输入价格低 40%（Google 价格页，2026 年 11 月 4 日核对）。

100,000 输入 token 加 20,000 输出 token 的请求最能把差距说清楚。在 2.5 Pro 上是 $0.125 + $0.20 = $0.325。在 3.8 Flash 上，2026 年 12 月 31 日之前是 $0.075 + $0.075 = $0.15，2027 年 1 月 1 日起是 $0.15 + $0.15 = $0.30。

先看 2027 那一行再庆祝。输入比 2.5 Pro 的 $1.25 高出 20%，输出比 2.5 Pro 的 $10.00 低 25%。输入占大头的请求，明年比今天用 2.5 Pro 更贵。

批量价格保持同样的形状：2.5 Pro 在 200,000 token 以内收 $0.625 输入、$5.00 输出，3.8 Flash 到 2026 年 12 月 31 日收 $0.375 和 $1.875（Google 价格页，2026 年 11 月 4 日核对）。

含缓存、Priority 和 2027 年数字的完整价目表，在Gemini 3.8 Flash 价格指南里。

2.5 Flash 和 2.5 Flash-Lite

2.5 Flash 同样在 12 月 1 日到期，2.5 Flash-Lite 不是。

Google 弃用页面（2026 年 11 月 4 日核对）给 gemini-2.5-flash 的条件和 2.5 Pro 一样：2025 年 6 月 17 日发布，2026 年 12 月 1 日起请求转到 gemini-3.5-flash-lite，计费改为 3.5 Flash-Lite 费率。gemini-2.5-flash-lite 没有弃用，继续提供。

两个音频 ID 要单独记进日历。gemini-2.5-pro-preview-tts 和 gemini-2.5-flash-preview-tts 在 2026 年 11 月 17 日停止服务，替代品是 gemini-3.8-flash-tts 或 gemini-3.8-flash-lite-tts。

更早的固定版 2.5 Pro 预览版早就下线了。gemini-2.5-pro-preview-03-25、-05-06 和 -06-05 的停止服务日是 2025 年 12 月 2 日。配置里还写这三个 ID 的，今天就已经在失败。

常见问题

Gemini 2.5 Pro 弃用了吗？

是的。Google 2026 年 11 月 2 日的版本更新记录把 gemini-2.5-pro 标为弃用，弃用页面把 2026 年 12 月 1 日定为所有 API 请求转到 gemini-3.8-flash 的日子（2026 年 11 月 4 日核对）。AI Studio 的模型选择器里已经没有它了。

2026 年 12 月 1 日我的调用会怎样？

照样返回答案。Google 说发往 gemini-2.5-pro 的请求会自动转到 gemini-3.8-flash，按 3.8 Flash 价格计费。同一张表也把 2026 年 12 月 1 日列为停止服务日，而响应里报哪个模型 ID，Google 没有说明。第一天把它记进日志。

Gemini 2.5 Pro 还能在 AI Studio 里用吗？

不能。Google 把 gemini-2.5-pro 从 AI Studio 的模型选择器里移除了，API 只对主动用过它的老用户开放，到 2026 年 12 月 1 日为止（Google 弃用页面和模型页，2026 年 11 月 4 日核对）。

什么都不改，代码会出错吗？

会。3.8 Flash 会拒绝旧字段：thinking_level: "minimal"、candidate_count、结尾的 model 轮次，以及缺 call_id 和 name 的 FunctionResponse。thinking_budget 必须改成 thinking_level，而 temperature、top_p、top_k 现在就已经被忽略。Google 的迁移指南逐条列了这些改动，最后一条非空轮次是 model 轮次的请求今天就会返回 HTTP 400。

Gemini 3.8 Flash 便宜多少？

到 2026 年 12 月 31 日为止，在 200,000 token 以内，输入便宜 40%，输出便宜 62.5%：$0.75 对 $1.25，$3.75 对 $10.00（每百万 token）。2027 年 1 月 1 日起，输入比 2.5 Pro 贵 20%，输出便宜 25%。

已核对来源

• Google Gemini API 弃用页面
• Google Gemini API 版本更新记录
• 迁移到 Gemini 3.8 Flash
• Gemini 3.6 API 变化与参数更新
• Gemini 2.5 Pro 模型页
• Gemini 3.8 Flash 模型页
• Gemini API 价格