> ## 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 Flash 与 2.5 Pro 已下架：替换模型与迁移方法

> 老张API已下架 gemini-2.5-flash、gemini-2.5-pro 和 gemini-2.5-flash-nothinking，继续调用会返回 503。改用 gemini-3.5-flash-lite 或 gemini-3.8-flash 只需修改 model；gemini-2.5-flash-lite 不受影响。

2026 年 11 月 12 日起，Gemini 2.5 Flash 与 Gemini 2.5 Pro 的三个模型 ID 已下架，继续调用会返回 503。Google 已宣布弃用这两款模型，请按下表换成 Gemini 3.x：接口地址、密钥和请求格式都不变。

* **发布日期**：2026 年 11 月 12 日
* **最后核对**：2026 年 11 月 12 日
* **当前状态**：已下架

## 关键信息

| 项目 | 内容 |
| - | - |
| 下架模型 | `gemini-2.5-flash`、`gemini-2.5-pro`、`gemini-2.5-flash-nothinking` |
| 下架时间 | 2026 年 11 月 12 日 |
| 调用现象 | HTTP 503，提示 `no available channels for model gemini-2.5-flash` |
| 不受影响 | `gemini-2.5-flash-lite`、`gemini-2.5-flash-image`（Nano Banana）、Gemini 3.x 与 Gemini 4 |
| 接口 | 不变：OpenAI 兼容 `/v1/chat/completions` 和 Gemini 原生 `/v1beta/models/{model}:generateContent` |

## 换成哪个模型

| 原模型 | 换成 | 说明 |
| - | - | - |
| `gemini-2.5-flash` | `gemini-3.5-flash-lite` | 与 `gemini-2.5-flash` 价格基本相同，适合对话、分类、抽取和批量任务 |
| `gemini-2.5-flash` | `gemini-3.8-flash` | 需要更好的代码、多模态和多步任务效果时使用 |
| `gemini-2.5-pro` | `gemini-3.8-flash` | 单价低于 `gemini-2.5-pro`，适合大多数推理与长文档任务 |
| `gemini-2.5-pro` | `gemini-3.1-pro-preview` | 复杂推理、长文档分析 |
| `gemini-2.5-flash-nothinking` | `gemini-3.5-flash-lite` | 低延迟场景，默认思考级别为 `minimal` |

Google 也把 `gemini-3.5-flash-lite` 和 `gemini-3.8-flash` 列为这两款模型的官方替代。各模型的单价与可用分组见[模型与价格总表](https://docs.laozhang.ai/models.md)，文中的价格对比按 2026 年 11 月 12 日的价格。

## 谁受影响

| 范围 | 内容 |
| - | - |
| 受影响 | `model` 为上述 3 个模型 ID 的请求，包括 OpenAI 兼容接口和 Gemini 原生接口 |
| 不受影响 | `gemini-2.5-flash-lite` 照常可用；图像模型 `gemini-2.5-flash-image`；Gemini 3.x 与 Gemini 4 文本模型 |

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

## 怎么迁移

**1. 替换模型 ID**

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

**2. 用自己的提示词测试**

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

**3. 核对价格与扣费**

在[模型与价格总表](https://docs.laozhang.ai/models.md)确认单价，在[令牌管理](https://api2.laozhang.ai/token)确认令牌分组可以调用新模型，切换后在[调用日志](https://api2.laozhang.ai/log)核对模型名和扣费。

OpenAI 兼容接口示例：

```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-lite",
    "messages": [
      {"role": "user", "content": "把这段会议记录整理成三条待办事项"}
    ]
  }'
```

Gemini 原生接口把路径里的模型名换掉即可，例如 `/v1beta/models/gemini-3.5-flash-lite:generateContent`，写法见 [Gemini 原生协议接入](https://docs.laozhang.ai/api-reference/gemini.md)。

## 常见问题

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

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

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

Google 官方的[模型弃用页](https://ai.google.dev/gemini-api/docs/deprecations)把 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`。当前价格以[模型与价格总表](https://docs.laozhang.ai/models.md)为准。

### Gemini 3.x 的思考（Thinking）怎么控制？

Gemini 3 系列通过请求参数调整思考级别，各模型默认级别不同，例如 Gemini 3.5 Flash-Lite 默认为 `minimal`。不要自行拼接 `-thinking`、`-nothinking` 等后缀，以[模型与价格总表](https://docs.laozhang.ai/models.md)列出的模型 ID 为准。

### gemini-2.5-flash 和 gemini-2.5-pro 还会恢复吗？

目前没有重新上架的计划。Google 已弃用这两款模型，如有变化会更新本页并在[公告索引](https://docs.laozhang.ai/changelog.md)发布通知。

## 信息来源与相关链接

* **Google 官方**：[Gemini API 模型弃用与停用日期](https://ai.google.dev/gemini-api/docs/deprecations)、[Vertex AI 模型版本与退役日期](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/model-versions)
* **老张API**：下架状态依据 2026 年 11 月 12 日的实际调用结果；当前可用模型、价格和扣费以[模型与价格总表](https://docs.laozhang.ai/models.md)和[调用日志](https://api2.laozhang.ai/log)为准
* **相关文档**：[Gemini 原生协议接入](https://docs.laozhang.ai/api-reference/gemini.md)、[Gemini 2.5 文本模型调用不稳定（10 月公告）](https://docs.laozhang.ai/announcements/gemini-2-5-unstable-2026-10.md)、[如何确认模型是否可用](https://docs.laozhang.ai/faq/model-availability.md)


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