# Gemini 2.5 Pro 弃用：12 月 1 日之后会变什么 > 2026 年 12 月 1 日起，Google 把 gemini-2.5-pro 请求转给 gemini-3.8-flash，按 3.8 Flash 价格计费。哪里会报错、怎么改。 - Canonical HTML: https://omniakey.com/zh/blog/gemini-2-5-pro-deprecated-migration-guide - Markdown: https://omniakey.com/zh/blog/gemini-2-5-pro-deprecated-migration-guide.md - Published: 2026-11-04 (updated 2026-11-04) - Author: Kiki, COO at OmniaKey - Language: zh - Category: Guide - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- 2026 年 12 月 1 日，Google 会把每个 [Gemini 2.5 Pro](https://omniakey.com/zh/gemini-2-5-pro) 请求转到 [Gemini 3.8 Flash](https://omniakey.com/zh/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 日核对）。 |你发出去的内容|会发生什么|要改什么| |-|-|-| |`thinking_budget`|3.8 的请求里已被替换|改用 `thinking_level`| |`thinking_level: "minimal"`|返回错误|改用 `low`、`medium` 或 `high`| |`temperature`、`top_p`、`top_k`|现在被忽略，后续模型代际返回 HTTP 400|删掉| |`candidate_count`|Gemini 3 及之后不支持|每次调用只留一个候选| |最后一条 `role: "model"` 轮次|HTTP 400|把规则写进 `system_instruction`| |缺 `call_id` 和 `name` 的 `FunctionResponse`|`Malformed_Function_Call`|两个字段都补上| 采样参数是最安静的那个故障。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 的思考签名页面，升级和签名保存都写在那里。 请求的前后对比一屏就够。改前： ```json { "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 } } ``` 改后： ```json { "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 模型页](https://omniakey.com/zh/gemini-3-8-flash)列了模型 ID、1M 上下文和三档思考等级。两个模型的当前费率在[价格页](https://omniakey.com/zh/pricing)。 ## 价格差多少 在标准付费档，到 2026 年 12 月 31 日为止，3.8 Flash 的输出价格不到 2.5 Pro 的一半，输入价格低 40%（Google 价格页，2026 年 11 月 4 日核对）。 |模型|每百万输入|每百万输出| |-|-|-| |`gemini-2.5-pro`，200,000 以内|$1.25|$10.00| |`gemini-2.5-pro`，超过 200,000|$2.50|$15.00| |`gemini-3.8-flash`，至 2026-12-31|$0.75|$3.75| |`gemini-3.8-flash`，自 2027-01-01|$1.50|$7.50| 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 价格指南](https://omniakey.com/zh/blog/gemini-3-8-flash-api-pricing)里。 ## 2.5 Flash 和 2.5 Flash-Lite 2.5 Flash 同样在 12 月 1 日到期，2.5 Flash-Lite 不是。 |模型|停止服务|替代模型| |-|-|-| |`gemini-2.5-flash`|2026 年 12 月 1 日|`gemini-3.5-flash-lite`| |`gemini-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 弃用页面](https://ai.google.dev/gemini-api/docs/deprecations) - [Google Gemini API 版本更新记录](https://ai.google.dev/gemini-api/docs/changelog) - [迁移到 Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8) - [Gemini 3.6 API 变化与参数更新](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6) - [Gemini 2.5 Pro 模型页](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro) - [Gemini 3.8 Flash 模型页](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash) - [Gemini API 价格](https://ai.google.dev/gemini-api/docs/pricing)