模型迁移Gemini

Gemini 2.5 Pro 下线:12 月迁移到 3.8 Flash

Gemini 2.5 Pro 不是“慢慢淘汰”,而是到 2026-12-01 直接停止服务,请求自动转到 3.8 Flash,并按 3.8 Flash 的价格计费。对已经调好提示词和输出格式的应用来说,这不是改一个模型名,而是一次静默的行为变更。

左侧渐暗的蓝色晶体球与右侧明亮的青色 Flash 球体,中间是发光迁移箭头与倒计时环

快速结论

这篇指南的直接答案是什么?

2026-12-01 起,gemini-2.5-pro 的请求自动路由到 gemini-3.8-flash,gemini-2.5-flash 路由到 gemini-3.5-flash-lite;2.5 Flash-Lite 暂未弃用。迁移前要盘点模型 ID、测试提示词和输出长度、调整 thinking 参数、重算价格,并在 12 月 1 日前灰度切流。3.8 Flash 的输入/输出价为每百万 token 0.75/3.75 美元(至 2026-12-31),之后翻倍。

购买前先记住这几点

  • 2.5 Pro 与 2.5 Flash 的下线日期都是 2026-12-01。
  • 2.5 Pro 自动路由到 3.8 Flash,2.5 Flash 路由到 3.5 Flash-Lite。
  • 2.5 Flash-Lite 暂未弃用,仍可继续使用。
  • 路由后按新模型价格计费,不再按 2.5 价格。
  • 迁移前必须测试提示词、输出格式和 thinking 参数。

直达入口:Google AI Pro 专区 · 帮助中心

哪些模型会在 12 月下线?

gemini-2.5-pro 和 gemini-2.5-flash 都在 2026-12-01 下线;gemini-2.5-flash-lite 不在弃用名单中,仍可通过 API 使用。

官方弃用页把 2.5 Pro 的替代模型标为 gemini-3.8-flash,把 2.5 Flash 的替代模型标为 gemini-3.5-flash-lite。两者从 2026-12-01 起自动路由,调用方不改代码也会被转到新模型。

2.5 Flash-Lite 的状态不同:官方明确它没有弃用,也没有自动路由日期。仍在用 Flash-Lite 的项目可以继续,但也要关注后续公告。

下线与替代关系
旧模型下线日期自动路由到状态
gemini-2.5-pro2026-12-01gemini-3.8-flash弃用
gemini-2.5-flash2026-12-01gemini-3.5-flash-lite弃用
gemini-2.5-flash-lite未公布无未弃用

自动路由后价格怎么变?

路由后按新模型价格计费:3.8 Flash 输入/输出 0.75/3.75 美元(至 2026-12-31,之后 1.50/7.50);3.5 Flash-Lite 为 0.30/2.50 美元。

2.5 Pro 原本按 1.25/10 美元(≤200k 输入)计费,路由到 3.8 Flash 后单价下降,但输出上限、thinking 和提示词行为也会变化。不要只看单价下降,就认为总成本一定下降。

2.5 Flash 原本按 0.30/2.50 美元计费,路由到 3.5 Flash-Lite 后价格接近,但模型能力和输出风格不同,仍需要重新测试。

价格对照(每百万 token,标准档)
模型输入输出备注
2.5 Pro$1.25 / $2.50$10 / $15按 200k 输入分档
3.8 Flash$0.75 → $1.50$3.75 → $7.502027-01-01 起翻倍
2.5 Flash$0.30$2.50音频输入 $1.00
3.5 Flash-Lite$0.30$2.50替代 2.5 Flash

行为差异在哪里?

3.8 Flash 的上下文、输出上限、thinking 档位和工具调用行为与 2.5 Pro 不同;直接路由可能改变输出长度、格式和延迟。

3.8 Flash 支持 1M 输入、64K 输出和 low/medium/high 三档 thinking。2.5 系列的思考控制方式不同,迁移时不要直接沿用旧的 thinking 参数。

输出长度、JSON 模式、函数调用和长上下文处理都可能变化。原本针对 2.5 Pro 调过的提示词,在 3.8 Flash 上可能变得过于啰嗦或过于简短。

  • 核对上下文与输出上限。
  • 重设 thinking 档位,不沿用旧参数。
  • 测试 JSON/结构化输出。
  • 测试函数调用与工具循环。
  • 对比延迟和 token 消耗。

迁移前要盘点什么?

盘点所有模型 ID、调用方、提示词模板、输出解析、计费预算和回退路径,再按流量优先级分批迁移。

先搜代码和配置里的 gemini-2.5-pro、gemini-2.5-flash 字符串,确认哪些是生产、哪些是测试。不要只改主服务,定时任务、批处理、Agent 和第三方集成也可能写死了旧模型。

把模型名抽成配置,保留一键回退。自动路由发生后,旧模型名仍可能被接受,但实际执行的是新模型,日志里要记录真实模型版本。

  1. 1搜索并列出所有 2.5 模型 ID。
  2. 2标记生产、测试、批处理和 Agent 调用。
  3. 3把模型名改为配置项。
  4. 4准备 3.8 Flash / 3.5 Flash-Lite 的回退方案。
  5. 5更新预算与告警。
  6. 6在 12 月 1 日前完成灰度。

怎么测试迁移效果?

用真实任务做 A/B:同一批输入分别跑 2.5 和新模型,比较质量、格式、延迟、token 和失败率,再决定是否调整提示词。

测试集要覆盖最短、最长、最复杂和最容易被解析的请求。只看几条聊天示例,发现不了 JSON 截断、函数调用参数变化和长上下文遗忘。

对输出格式敏感的应用,增加结构校验和自动重试;对成本敏感的应用,统计输入/输出 token 和 thinking 消耗,重新估算月度账单。

  • 20–50 条真实任务。
  • 覆盖长短输入和工具调用。
  • 比较质量、延迟、token。
  • 校验 JSON 与函数参数。
  • 记录失败率和重试次数。

上线时怎么降风险?

灰度切流、保留回退、监控错误率和成本;不要在 12 月 1 日当天一次性切换全部流量。

先把低风险流量切到新模型,观察 24–48 小时;再逐步扩大。自动路由是不可逆的,旧模型下线后无法再切回,所以回退方案只能是另一个可用模型,而不是 2.5。

在 12 月 1 日前完成切换,比等自动路由更可控。自动路由发生时,你的监控、日志和预算可能同时变化,排查成本更高。

  1. 1先切测试和低风险流量。
  2. 2监控错误率、延迟和成本。
  3. 3逐步扩大流量比例。
  4. 4保留 3.8 Flash/3.5 Flash-Lite 回退。
  5. 5更新日志中的模型版本。
  6. 6在 12 月 1 日前完成全量。

实时商品

文章不写死站内价格。进入商品页可查看实时售卖状态;显示暂时缺货时无法下单。

查看全部商品

价格与套餐:Gemini Pro 价格:开通包与成品号

以下页面的价格、库存与售卖状态都实时读取商品数据,可作为本文的购买与核对入口。

资料来源与复核范围

套餐和功能会变化。以下官方资料已在页面最后更新时间复核;购买前仍应打开来源查看当前版本。

  1. 1. Gemini API|模型文档 ↗

    核对 2.5 与 3.x 模型的 ID、定位、状态和替代关系。

  2. 2. Gemini API|弃用与下线 ↗

    核对 2.5 Pro/Flash 的下线日期、替代模型与自动路由时间。

  3. 3. Gemini API|价格 ↗

    核对 2.5、3.8 Flash、3.5 Flash-Lite 的输入输出价格与免费层。

  4. 4. Gemini API|Gemini 3.8 Flash ↗

    核对 3.8 Flash 的上下文、输出上限、thinking 档位与迁移要求。

常见问题

Gemini 2.5 Pro 什么时候下线?

2026-12-01。此后请求自动路由到 gemini-3.8-flash。

2.5 Flash 也会下线吗?

会。2026-12-01 起自动路由到 gemini-3.5-flash-lite。

2.5 Flash-Lite 还能用吗?

可以。官方弃用页明确它未弃用,仍可通过 API 使用。

自动路由后按什么价格计费?

按新模型价格计费:3.8 Flash 或 3.5 Flash-Lite 的标准价,不再按 2.5 的价格。

不改代码会怎样?

请求仍可能成功,但实际执行的是新模型,输出行为、延迟和账单都会变化;建议在 12 月 1 日前主动迁移。

继续阅读

查看全部 →