AI Studio 里找不到 Gemini 2.5 Pro？先查访问资格，别急着判断停用

选择器里没有 Gemini 2.5，不等于 Google 已经停用该模型。 Google 在 2026 年 9 月 18 日的 Gemini API 更新日志中说明，2.5 系列的访问将限于此前活跃使用过这些模型的用户。同一公告明确表示，它们尚未弃用，服务将继续提供，直至另行通知。

对于新项目，Google 建议采用 Gemini 3.5 Flash-Lite 或 Gemini 3.8 Flash 等较新模型。如果是在维护已有集成，先确定故障发生在哪条访问路径。本文区分访问政策、API Key、项目和请求问题，不承诺恢复使用资格。

看不到模型，为什么不等于关停

Google AI 开发者论坛的一则用户报告描述了 9 月 18 日 Gemini 2.5 Pro 从 AI Studio 消失的情况。它证明有人遇到了这个现象，不证明所有账号都失去了访问权。

官方公告要求过往活跃使用，但未公开量化门槛。不能仅凭账号注册时间、付费订阅或一次调用成功，推导具体资格。AI Studio 选择器、直连 Gemini API 和第三方模型目录是不同入口。

本文讨论的是 Gemini API 公告，不能据此断言 Vertex AI、每种 Google 订阅和所有第三方供应商都采用同样限制。

分别检查账号、项目和模型

先确认当前账号和项目是否正确。团队常有多个项目，切错项目可能看起来像模型被移除。上下文信息私下记录，不要把项目标识、API Key 或含凭据的截图贴到公开求助帖。

再检查应用发送的模型字符串。“Gemini 2.5 Pro”这样的显示名称，不等于请求中的精确 ID。使用供应商文档规定的模型列表操作，核对本次凭据和路由。调用失败时保存完整错误响应，以及供应商返回的请求标识。

列模型成功，不保证每个模型都支持你准备调用的操作。还要核对生成方法与输入类型。生成请求被拒绝也不自动等于停用：鉴权、账号资格、配额和输入格式都可能有独立问题。

不要靠反复更换计费方式或新建账号来解决。引用的公告没有把这两种操作列为恢复资格的方法。如果界面状态与已知使用历史冲突，向 Google 支持或官方论坛提交最小化、脱敏的复现信息。

先查询直接 API 的模型列表，不发送生成任务

直接 Gemini API 可以使用官方 Models API。这是元数据查询，不是模型生成请求。使用正在排查的项目所对应的 Key，换成另一个正常项目的 Key 会回答另一个问题。通过环境变量提供密钥，不要放进公开 URL 或记录。

curl --silent --show-error \
  -D models-headers.txt -o models.json -w '%{http_code}\n' \
  'https://generativelanguage.googleapis.com/v1beta/models?pageSize=1000' \
  -H "x-goog-api-key: $GEMINI_API_KEY"

最后打印的数字是 HTTP 状态码，先记录它再查看 models.json。200 响应应包含 models 数组；错误响应不能当作“查询成功但模型为空”。下面的本地命令输出精确匹配的名称及其声明支持的生成方法：

python3 - <<'PYCODE'
import json
from pathlib import Path
body = json.loads(Path('models.json').read_text())
if 'error' in body or not isinstance(body.get('models'), list):
    raise SystemExit('Not a successful model-list response; inspect models.json')
for model in body['models']:
    if model.get('name') == 'models/gemini-2.5-pro':
        print(model['name'], model.get('supportedGenerationMethods', []))
if body.get('nextPageToken'):
    print('More pages exist; follow nextPageToken before concluding absence.')
PYCODE

没有匹配输出只代表这一页没有该模型。若有 nextPageToken，把它作为 URL 编码后的 pageToken 查询参数再次请求并检查后续页。不要根据不完整列表断言模型退役。资源名称包含 models/，下方生成 URL 也在路径中使用这一资源名称。

把结果与失败应用的时间、项目上下文一起保存，有助于区分“UI 选择器变了”与“同一份 API 凭据不再展示该 ID”。列表查询不能赋予资格，也不能解释未公开的账户规则。

有使用授权时，再做一次最小生成检查

生成请求可能消耗配额或产生费用。如果账户允许这类检查，将下面的最小文本请求保存为 access-check.json。先不加工具、上传文件或额外生成参数，避免无关参数掩盖访问问题。

{"contents":[{"parts":[{"text":"Reply with the word ready."}]}]}

curl --silent --show-error \
  -D access-headers.txt -o access-response.json -w '%{http_code}\n' \
  'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-pro:generateContent' \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @access-check.json

成功响应通常在 JSON 中包含候选内容。查看文本 part、结束原因和安全信息；没有可用答案不等于模型不可用。这些命令是复现步骤，不是本文账户当前调用成功的声明。不要自动循环重试。

结合 Google 的故障排查文档和实际错误正文处理：

最小直接请求成功、应用却失败时，对比应用实际使用的 Key/项目、模型字符串和发出的请求。如果只有 AI Studio 缺少模型，单独报告 UI/账户现象；如果两者都失败，把两份脱敏观察交给支持，不要断言其中一个已经证明另一个的原因。

保存一份最小故障记录

观察时间（UTC）：
入口：AI Studio / Gemini API / 供应商网关
精确模型 ID：
客户端或 SDK 版本：
已确认账号和项目：是/否
操作与输入类型：
HTTP 状态及脱敏后的错误正文：
请求 ID（如有）：
上次成功运行的时间和留存证据：

这是排查模板，不是实测结果。上次成功记录只有在路由和相关账号上下文一致时才有参考价值。别人模型选择器中的截图，不能证明你的账号有同样资格。

需要迁移工作流时怎么选

按任务选择替代模型，不要只比较版本号。把文本生成、结构化提取、图片输入和工具调用分开，切换生产流量前检查参数和响应处理。

提取任务应重放代表性文档，同时检查内容准确性和结构合法性；工具调用应验证完整调用及结果序列，不能只看第一条回复。把输出限制、超时与异常处理也保存在测试记录中。

如果依赖特定预览模型，需要另查它的生命周期公告。预览版退役与 9 月 18 日的访问政策不是同一件事，不宜概括为“Gemini 2.5 全部关停”。

可以从 Gemini 3.8 Flash API 指南了解较新路由。Gemini 工具调用签名排查处理的是另一种迁移故障，即使模型访问正常，也可能发生。

迁移时保留原工作流的输出约定

例如，发票提取服务的约定可能是：发票编号始终为字符串、保留前导零、缺失金额返回 null、不编造供应商。这些要求比保留熟悉的展示名称更重要。尝试替代模型前，保存获准使用的代表性输入及预期值。

建立迁移表，记录旧精确 ID、候选精确 ID、必需输入类型、schema/工具支持、输出上限、观察到的失败和回退路径。Google 公告推荐的新 Flash 或 Flash-Lite 是候选，不代表推理和每项功能都与 2.5 Pro 等效。比较时保持文档及预期答案不变。

先在隔离测试或影子流程中运行替代模型，再修改生产默认值。核对解析后的字段、工具调用顺序、拒绝/错误处理及延迟约束。满足标准后一次性切换配置，保留之前正常的设置。只有旧接口仍有授权且可用时才能回退，保存模型名不能恢复已取消的访问资格。

没有合适接口时，将受影响工作排队或按既定人工流程处理。换付费套餐、新建账户或选择名称相似的网关模型，都不是 9 月 18 日资格规则的官方修复方法。本指南最终可能帮助你作出有证据的迁移决定或提交清楚的支持案例，而不一定让选择器恢复。

网关可用能说明什么

网关有自己的目录、凭据、计费和上游路由。网关列出可用模型，不证明你的 Google 项目仍有资格；Google 直连受限，也不证明所有网关都不可用。

选择 Ofox 或其他供应商时，按使用当时的情况确认精确模型和请求格式。更换 Base URL 不代表保留全部 Gemini 原生功能。本文没有断言 Ofox 当前提供某条 Gemini 2.5 路由。