> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini 2.5 文本模型调用不稳定：受影响模型与迁移到 Gemini 3.x

> 2026 年 10 月起 Gemini 2.5 Flash、Flash-Lite 与 Pro 在老张API的上游容量不足，部分请求返回 429 或 5xx。本页说明受影响的模型 ID、推荐替换的 Gemini 3.x 模型和迁移步骤。

* **发布日期**：2026 年 10 月 23 日
* **最后核对**：2026 年 10 月 23 日
* **当前状态**：观察中。模型没有下架，仍可调用，但成功率不稳定

2026 年 10 月 20 日起，老张API的 Gemini 2.5 文本模型上游可用容量不足，一部分请求会返回 429 或 5xx。Google 官方并未弃用这些模型，老张API也暂不下架；生产环境建议换到下表中的 Gemini 3.x 模型，只需修改请求里的 `model`。

## 受影响的模型与推荐替换

| 受影响模型 | 推荐替换 | 说明 |
| - | - | - |
| `gemini-2.5-flash` | `gemini-3.5-flash` 或 `gemini-3.6-flash` | 通用对话、代码与多模态理解 |
| `gemini-2.5-flash-nothinking` | `gemini-3.5-flash-lite` | 低延迟场景，默认思考级别为 `minimal` |
| `gemini-2.5-flash-lite` | `gemini-3.1-flash-lite` 或 `gemini-3.5-flash-lite` | 分类、抽取、批量任务 |
| `gemini-2.5-pro` | `gemini-3.1-pro-preview` | 复杂推理与长文档分析 |

推荐的替换模型当前调用正常，都支持 OpenAI 兼容和 Gemini 原生两种接口。价格与可用分组以[模型与价格总表](/models.md)为准。

## 谁受影响

* **受影响**：调用上表 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. **确认价格与分组**：在[模型与价格总表](/models.md)确认目标模型的单价，在[令牌管理](https://api2.laozhang.ai/token)确认令牌所在分组可以调用它。
4. **核对扣费**：切换后在[调用日志](https://api2.laozhang.ai/log)确认模型名、用量和扣费，再逐步恢复全部流量。

OpenAI 兼容接口示例（Gemini 原生接口把路径中的模型名换成 `gemini-3.5-flash` 即可，例如 `/v1beta/models/gemini-3.5-flash:generateContent`）：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl https://api.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      {"role": "user", "content": "把这段会议记录整理成三条待办事项"}
    ]
  }'
```

暂时必须使用 Gemini 2.5 的业务，请为 429 和 5xx 加上带退避的重试，并降低并发，避免短时间集中重试。

## 常见问题

### Gemini 2.5 是被 Google 下线了吗？

不是。Google 的[模型弃用页](https://ai.google.dev/gemini-api/docs/deprecations)显示，`gemini-2.5-flash`、`gemini-2.5-flash-lite` 和 `gemini-2.5-pro` 没有公布停用日期。

本次不稳定来自老张API当前可用的上游容量。Google 也建议新项目使用最新的 Gemini 模型。

### 老张API会下架 Gemini 2.5 吗？

暂不下架，模型 ID 保持可用。状态恢复或发生变化时会更新本页，并在[公告索引](/changelog.md)发布通知。

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

会。Gemini 3.x 与 2.5 的单价不同，以[模型与价格总表](/models.md)为准，扣费以[调用日志](https://api2.laozhang.ai/log)为准。

### 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 公告](/announcements/gemini-flash-models-2026-07.md)。

### 为什么不推荐 Gemini 3.8 Flash？

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

## 信息来源与相关链接

* **Google 官方**：[Gemini API 模型弃用与停用日期](https://ai.google.dev/gemini-api/docs/deprecations)、[最新 Gemini 模型说明](https://ai.google.dev/gemini-api/docs/latest-model)
* **老张API状态**：本公告依据 2026 年 10 月 20 日至 23 日老张API网关的调用情况整理；当前可用分组、价格和扣费以[模型与价格总表](/models.md)和[调用日志](https://api2.laozhang.ai/log)为准。
* **相关文档**：[Gemini 原生协议接入](/api-reference/gemini.md)、[OpenAI SDK 接入指南](/api-manual.md#openai-sdk)、[如何确认模型是否可用](/faq/model-availability.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.