Gemini 2.5 API 还能用吗？9月访问收紧与10月20日 Vertex AI 退役前的中转核验清单
Google 已限制新项目访问 Gemini 2.5，Vertex AI 还列出 2026 年 10 月 20 日的退役时间。本文区分 Gemini API 与 Vertex AI 的生命周期，整理中转渠道迁移前必须核对的模型 ID、接口能力、价格和回滚证据。
正文
Gemini 2.5 API 还能用吗？9月访问收紧与10月20日 Vertex AI 退役前的中转核验清单
如果你的 Claude Code、Cursor、代码审查脚本或 Agent 还在调用 gemini-2.5-pro、gemini-2.5-flash，现在最容易出现的误判是：看到请求暂时还能成功，就认为这条模型路线可以继续按原计划扩容。
截至 2026 年 9 月 28 日，Google 的信息其实分成两条线：
- Gemini API 在 9 月 18 日宣布，Gemini 2.5 仍会继续提供，但访问限制为此前主动使用过这些模型的用户；新项目建议使用
gemini-3.5-flash-lite或gemini-3.8-flash。 - Google Cloud 的 Vertex AI / Gemini Enterprise Agent Platform 生命周期表则把
gemini-2.5-pro、gemini-2.5-flash和gemini-2.5-flash-lite的退役日期列为 2026 年 10 月 20 日，并给出了 3.x 替代模型。
所以，“Gemini 2.5 还能不能用”不能只回答能或不能。你需要先确认自己使用的是哪条上游路径，以及中转渠道把请求转到了哪条路径。
先给结论：不要把“访问收紧”和“立即关停”混为一谈
Gemini API：旧用户还能用，但新项目不应再把 2.5 当默认入口
Google AI for Developers 的更新说明没有宣布 Gemini 2.5 API 在 9 月 18 日当天关停。官方表述是：为了保证整体服务性能，2.5 模型将限制给过去主动使用过它们的用户；这些模型没有被标记为弃用，并会继续通过 API 提供，直到另行通知。新项目建议使用 Gemini 3.5 Flash-Lite 或 Gemini 3.8 Flash。
这对中转 API 用户有两个直接影响：
- “模型列表里有 2.5”不等于新账号、新项目一定能调用。 上游项目资格、账号历史和渠道使用的 Google 项目都可能影响结果。
- 已有 2.5 流量也不应继续无限放大。 访问策略可能在渠道、账号或项目层面表现为模型不存在、权限不足、配额受限，或者在高峰时段出现不同结果。
Vertex AI：需要按 10 月 20 日做迁移排期
Vertex AI 的模型生命周期表明确列出：
| 当前模型 | Vertex AI 退役日期 | 官方列出的替代方向 |
|---|---|---|
gemini-2.5-pro |
2026-10-20 | gemini-3.5-flash |
gemini-2.5-flash |
2026-10-20 | gemini-3.5-flash-lite 或 gemini-3.1-flash-lite |
gemini-2.5-flash-lite |
2026-10-20 | gemini-3.1-flash-lite 或 Gemma 4 |
这里的“替代”是平台生命周期层面的建议，不代表新模型在你的代码库、工具调用、输出格式和最终成本上与 2.5 完全等价。尤其是 gemini-2.5-pro 到 gemini-3.5-flash，不能只做字符串替换就认为迁移完成。
为什么中转渠道更容易把这次变化说不清
一个中转站的页面可能只展示“支持 Gemini 2.5”，但这句话至少可能对应四种不同情况：
- 仍有可用的 Gemini API 旧项目；
- 通过 Vertex AI 调用，正在等待 10 月 20 日退役；
- 使用了自定义别名，实际已经映射到 3.x 模型；
- 只验证过普通文本请求，没有验证工具调用、长上下文、流式输出或多模态。
因此，选择渠道时不要只截一张模型列表截图。你需要让渠道明确回答：精确模型 ID、上游接口形态、适用账号或项目范围、生命周期、计费单位，以及是否保留请求中的关键参数。 如果对方只说“Gemini 全系可用”，这只能算线索，不能算兼容性证据。
迁移前的 7 项核验清单
1. 记录完整模型 ID，不使用模糊别名
先在代码、环境变量、配置中心、队列任务和 Agent 路由规则中搜索：
gemini-2.5-pro
gemini-2.5-flash
gemini-2.5-flash-lite
同时确认渠道实际接受的替代 ID，例如：
gemini-3.5-flash
gemini-3.5-flash-lite
gemini-3.1-flash-lite
gemini-3.8-flash
不要默认 gemini-flash-latest、gemini-pro-latest 或渠道自定义名称会固定指向某个版本。别名一旦自动漂移，模型升级和账单变化就会被混在一起。
2. 分开测试“模型可见”“基础请求成功”和“业务链路通过”
建议把验收拆成三层：
| 验收层 | 最小测试 | 你要记录的证据 |
|---|---|---|
| 模型可见 | 查询模型列表或渠道模型详情 | 完整 ID、上下文限制、状态时间 |
| 基础请求 | 一次短文本 generateContent 或兼容接口请求 |
HTTP 状态、上游错误、响应模型名、请求 ID |
| 业务链路 | 流式输出、工具调用、结构化输出、长上下文 | 参数是否被保留、事件是否完整、重试后结果 |
一个短文本请求成功，只能说明基础路径在这个时间点可用；它不能证明编程代理的工具调用或长任务也可用。
3. 对代码 Agent 单独回归工具调用
如果你把 Gemini 用在代码修改、测试修复或浏览器 Agent 中，至少准备一条带函数声明的测试：
- 模型先返回工具调用；
- 客户端执行一个无副作用的测试工具；
- 把工具结果回传给模型；
- 检查模型是否能继续输出最终结果；
- 记录流式和非流式两种返回是否一致。
迁移时重点观察工具名称、参数 JSON、并行调用、思考字段和停止原因。任何一项被中转层裁剪，都可能表现为“模型能聊天，但 Agent 不会工作”。
4. 对比输入、输出和思考 Token 的账单口径
不要把 Google 官方价格直接当成中转站最终价格。至少需要分开记录：
- 上游模型的输入、输出及缓存价格；
- 中转站展示的价格、倍率、分组和充值门槛；
- 实际请求的输入 Token、输出 Token、思考 Token 和重试次数；
- 失败请求是否扣费，自动重试是否重复扣费。
对于代码 Agent，模型更换后总成本可能不只是单价变化：输出长度、工具调用轮数、失败重试和上下文重复发送都会改变总账单。迁移前最好用同一组脱敏任务分别跑旧模型和候选模型，保存请求 ID 与扣费记录。
5. 不要用一次成功请求证明长期可用
在 2026 年 9 月 28 日做一次成功测试，只能说明该账号、该项目、该渠道和该时间点通过了测试。建议至少记录：
- 测试时间和时区；
- 使用的完整模型 ID；
- API 入口和请求格式；
- 流式或非流式模式；
- 工具调用、长上下文和多模态是否参与；
- HTTP 状态、上游错误文本、响应模型名和账单变化。
如果渠道声称仍然提供 Gemini 2.5，直接追问它属于 Gemini API 还是 Vertex AI，以及 10 月 20 日之后的替代方案。无法给出明确上游和迁移计划时，不宜把它作为唯一生产渠道。
6. 先做小流量双写或可回滚配置
迁移顺序可以是：
- 把模型 ID 从业务代码中抽成配置；
- 为 2.5 和候选 3.x 分别保留独立的路由配置；
- 用脱敏、低风险任务进行小流量对照；
- 对比正确率、工具完成率、平均输出 Token、错误码和扣费；
- 确认新路径后再扩大流量；
- 在 10 月 20 日前删除对 Vertex AI 2.5 的硬编码依赖。
如果渠道只提供一个无法解释的别名，不建议在迁移窗口内把它直接接入关键生产任务。
7. 把“渠道可用”写成有时间范围的结论
渠道目录、模型页面和人工回复都可能变化。记录时用下面这种表述更准确：
截至 2026-09-28 15:00 UTC，渠道 X 的 gemini-2.5-pro
在账号/项目 Y、接口 Z、非流式文本测试中返回成功；
工具调用、流式输出和 2026-10-20 之后的可用性尚未验证。
这比“支持 Gemini 2.5，稳定可用”更接近真实证据，也方便后续复测和替换。
Gemini API 与 Vertex AI，应该怎么选迁移目标
如果是新项目，优先从 gemini-3.5-flash-lite、gemini-3.5-flash 或 gemini-3.8-flash 中按任务做小样本回归，而不是重新建设在 2.5 上。Google 的模型页把 3.8 Flash定位为面向长时软件工程、自治 Agent 和复杂工作流的稳定模型；这说明它是值得纳入候选集的迁移目标，但不是对你的业务结果作保证。
如果是已有项目，先判断是否真的需要保留 2.5：
- 如果历史任务依赖 2.5 的输出风格、工具调用或视觉行为，优先做等价回归；
- 如果主要是高吞吐分类、提取和轻量子任务，可以把 3.5 Flash-Lite 或 3.1 Flash-Lite 放入成本对照；
- 如果是复杂代码和长链路 Agent，则应把 3.5 Flash、3.8 Flash 以及至少一个备用渠道放进测试矩阵；
- 如果依赖 Vertex AI 的项目、区域、IAM 或配额管理，需要单独核对新模型在原区域和原接口上的可用性。
“官方推荐替代”是起点，不是验收结论。真正的迁移完成，应该以你的业务回归、接口兼容和账单核对为准。
给中转 API 用户的最终判断
在这次变化中，最重要的不是急着找一个写着“Gemini 2.5”的页面，而是把模型可用性拆成可验证的事实：
- 上游是哪条线：Gemini API 的访问收紧，还是 Vertex AI 的明确退役日期？
- 模型是不是精确 ID：渠道是否真的提供
gemini-2.5-pro，还是用别名映射？ - 功能是否完整：基础文本、流式、工具调用、结构化输出和多模态是否分别通过？
- 账单是否透明：官方价、渠道价、倍率、思考 Token 和重试扣费是否分开？
- 有没有替代和回滚：候选 3.x 模型、备用渠道和切换开关是否提前验证？
如果你现在仍依赖 Gemini 2.5，建议把 2026 年 10 月 20 日当成 Vertex AI 迁移检查点，而不是等到请求报错后再处理。比较中转渠道时，优先选择能够提供精确模型名、测试条件、上游说明和可复核账单的渠道；不能仅凭目录收录、一次成功或宣传语推断长期稳定性。
参考来源
- Google AI for Developers：Gemini API 更新记录（2026 年 9 月 18 日访问限制说明、3.8 Flash 发布信息）：https://ai.google.dev/gemini-api/docs/changelog
- Google AI for Developers：Gemini 模型弃用与生命周期：https://ai.google.dev/gemini-api/docs/deprecations
- Google Cloud：Gemini Enterprise Agent Platform 模型版本与生命周期（Vertex AI 2.5 退役日期及替代模型）：https://cloud.google.com/vertex-ai/generative-ai/docs/learn/model-versions
- Google AI for Developers：Gemini API 模型列表（精确模型 ID 与当前稳定模型）：https://ai.google.dev/gemini-api/docs/models
- OpenRouter：Gemini 2.5 Pro 模型页（第三方渠道页面对 2026 年 10 月 20 日可用性提示，仅作交叉核验）：https://openrouter.ai/google/gemini-2.5-pro
资料核验时间：2026 年 9 月 28 日。模型可用性、渠道映射、价格、配额和退役安排可能继续变化；实际接入前请以对应上游和渠道的最新页面、账号测试及账单记录为准。