跳转到主要内容
  • 发布日期:2026 年 10 月 23 日
  • 最后核对:2026 年 10 月 23 日
  • 当前状态:观察中。模型没有下架,仍可调用,但成功率不稳定
2026 年 10 月 20 日起,老张API的 Gemini 2.5 文本模型上游可用容量不足,一部分请求会返回 429 或 5xx。Google 官方并未弃用这些模型,老张API也暂不下架;生产环境建议换到下表中的 Gemini 3.x 模型,只需修改请求里的 model。

受影响的模型与推荐替换

推荐的替换模型当前调用正常,都支持 OpenAI 兼容和 Gemini 原生两种接口。价格与可用分组以模型与价格总表为准。

谁受影响

  • 受影响:调用上表 4 个 Gemini 2.5 文本模型 ID 的请求,包括 OpenAI 兼容接口和 Gemini 原生接口。
  • 不受影响:Gemini 3.x 文本模型,以及图像模型 gemini-2.5-flash-image(Nano Banana)。
失败请求会返回 429(上游繁忙)或 5xx(上游服务异常)。同一个模型可能一部分请求成功、一部分失败,这是上游容量不足的表现,不是请求参数错误。

迁移步骤

  1. 替换模型 ID:按上表把 model 改成对应的 Gemini 3.x 模型,接口地址和密钥不用改。
  2. 小流量验证:用自己的提示词做对照测试,重点看思考行为、工具调用、结构化输出、token 用量和延迟是否符合预期。
  3. 确认价格与分组:在模型与价格总表确认目标模型的单价,在令牌管理确认令牌所在分组可以调用它。
  4. 核对扣费:切换后在调用日志确认模型名、用量和扣费,再逐步恢复全部流量。
OpenAI 兼容接口示例(Gemini 原生接口把路径中的模型名换成 gemini-3.5-flash 即可,例如 /v1beta/models/gemini-3.5-flash:generateContent):
暂时必须使用 Gemini 2.5 的业务,请为 429 和 5xx 加上带退避的重试,并降低并发,避免短时间集中重试。

常见问题

Gemini 2.5 是被 Google 下线了吗?

不是。Google 的模型弃用页显示,gemini-2.5-flash、gemini-2.5-flash-lite 和 gemini-2.5-pro 没有公布停用日期。 本次不稳定来自老张API当前可用的上游容量。Google 也建议新项目使用最新的 Gemini 模型。

老张API会下架 Gemini 2.5 吗?

暂不下架,模型 ID 保持可用。状态恢复或发生变化时会更新本页,并在公告索引发布通知。

换成 Gemini 3.x 后价格会变吗?

会。Gemini 3.x 与 2.5 的单价不同,以模型与价格总表为准,扣费以调用日志为准。

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

Gemini 3 系列通过请求参数调整思考级别,各模型的默认级别不同,例如 Gemini 3.6 Flash 默认为 medium,Gemini 3.5 Flash-Lite 默认为 minimal。 不要自行拼接 -thinking、-nothinking 等后缀,以控制台列出的模型 ID 为准。详见 Gemini 3.6 Flash 与 3.5 Flash-Lite 公告。

为什么不推荐 Gemini 3.8 Flash?

Gemini 3.8 Flash 本身可以调用,但近期部分时段上游同样繁忙。需要稳定生产时,先使用上表中的替换模型。

信息来源与相关链接