跳转到主要内容
2026 年 11 月 12 日起,Gemini 2.5 Flash 与 Gemini 2.5 Pro 的三个模型 ID 已下架,继续调用会返回 503。Google 已宣布弃用这两款模型,请按下表换成 Gemini 3.x:接口地址、密钥和请求格式都不变。
  • 发布日期:2026 年 11 月 12 日
  • 最后核对:2026 年 11 月 12 日
  • 当前状态:已下架

关键信息

换成哪个模型

Google 也把 gemini-3.5-flash-lite 和 gemini-3.8-flash 列为这两款模型的官方替代。各模型的单价与可用分组见模型与价格总表,文中的价格对比按 2026 年 11 月 12 日的价格。

谁受影响

下架前几天,这两款模型已有大量请求返回 HTTP 500(code 为 403)或 429,失败的请求不扣费。现在请求会直接返回 503,不会被转到其他模型。

怎么迁移

1

替换模型 ID

按上表把 model 改成对应的 Gemini 3.x 模型,接口地址和密钥不用改。
2

用自己的提示词测试

重点看回答质量、思考行为、工具调用、结构化输出和 token 用量是否符合预期。
3

核对价格与扣费

在模型与价格总表确认单价,在令牌管理确认令牌分组可以调用新模型,切换后在调用日志核对模型名和扣费。
OpenAI 兼容接口示例:
Gemini 原生接口把路径里的模型名换掉即可,例如 /v1beta/models/gemini-3.5-flash-lite:generateContent,写法见 Gemini 原生协议接入。

常见问题

现在调用 gemini-2.5-flash 会怎么样?

请求返回 HTTP 503,提示该模型没有可用渠道,例如 Current group default has no available channels for model gemini-2.5-flash。请求不扣费,也不会被转到其他模型,需要你自己修改 model。

Google 不是 12 月 1 日才停用吗?为什么现在就下架?

Google 官方的模型弃用页把 Gemini API 上 gemini-2.5-flash 和 gemini-2.5-pro 的停用日期定为 2026 年 12 月 1 日,Vertex AI 上的退役日期是 2026 年 10 月 20 日。 11 月 9 日起这两款模型的可用容量持续下降,大部分请求已经失败,老张API因此提前下架,避免请求等待十几秒后才失败。

gemini-2.5-flash-lite 还能用吗?

能用。Google 弃用页写明 gemini-2.5-flash-lite 没有停用日期,老张API继续提供,调用方式和价格都不变。

换成 gemini-3.5-flash-lite 价格会变吗?

基本不变。按 2026 年 11 月 12 日的价格,gemini-3.5-flash-lite 与 gemini-2.5-flash 的输入单价相同、输出单价基本相同,gemini-3.8-flash 的单价低于 gemini-2.5-pro。当前价格以模型与价格总表为准。

Gemini 3.x 的思考(Thinking)怎么控制?

Gemini 3 系列通过请求参数调整思考级别,各模型默认级别不同,例如 Gemini 3.5 Flash-Lite 默认为 minimal。不要自行拼接 -thinking、-nothinking 等后缀,以模型与价格总表列出的模型 ID 为准。

gemini-2.5-flash 和 gemini-2.5-pro 还会恢复吗?

目前没有重新上架的计划。Google 已弃用这两款模型,如有变化会更新本页并在公告索引发布通知。

信息来源与相关链接