Gemini 进不去或无法使用？先分清网页、AI Studio、API 与 CLI
Gemini 进不去，先看出错的入口。 gemini.google.com 的账号提示、AI Studio 的访问限制、程序中的 API 错误，以及终端里的 Gemini CLI 认证失败，需要检查的对象不同。先记录地址或命令和完整错误，再沿对应路径处理，避免为网页登录问题反复更换 API Key。
这篇指南帮助你判断故障发生在哪一步，并留下能够继续排查的证据。具体 CLI 安装和自定义接口配置见《Gemini CLI 国内使用教程》；已确认是云岚API调用报错的，可直接看《API 错误体与日志排查》。
第一步：确认你用的是哪一个 Gemini 入口
| 入口 | 怎么辨认 | 先保留什么 | 本轮检查的通过条件 |
|---|---|---|---|
| Gemini 网页聊天 | 浏览器地址是 gemini.google.com | 页面提示、账号类型、出错时间 | 目标账号进入对话，并完成一条普通文本问答 |
| Google AI Studio | 地址是 aistudio.google.com | 跳转地址、访问限制提示、当前项目 | 目标功能可以使用；“能看项目”不等于“能创建 Key” |
| Gemini API | 程序、SDK 或 REST 请求返回错误；Google 原生 API 常见域名为 generativelanguage.googleapis.com | 实际请求域名、接口路径、HTTP 状态和错误体 | 目标项目、模型和接口完成一次最小生成请求 |
| Gemini CLI | 终端执行 gemini 后无法启动、认证或请求 | gemini --version、所选认证方式、报错阶段 | 同一认证方式下完成一次简单请求；工具调用另行检查 |
这些通过条件是排查用的观察标准，不保证后续所有模型、工具或额度都可用。若程序连接的是第三方域名，或使用 Google Cloud 的 Vertex AI 接口，应查该服务自己的项目、凭据与接口说明；不要把一个入口的处理办法直接套给另一个。
Gemini 网页无法登录：先核对账号与页面提示
Google 的Gemini 登录帮助按个人、工作和学校账号分别说明访问条件，并提供支持的浏览器与故障提示。网页可用地区也有独立列表，不能用 AI Studio 的地区列表代替。
- 确认当前账号。 检查头像下实际登录的是哪个账号，尤其是同时登录个人和工作账号时。记录账号类型即可，分享截图时遮住邮箱。
- 按原始提示核对资格。 “无法访问此服务”应查当前账号的使用资格；工作或学校账号需要由管理员核对服务是否开放。涉及年龄或受监护账号时，沿页面当前给出的帮助流程处理，不修改不实资料。
- 区分登录受限与页面加载失败。 已显示明确账号提示，就先处理该提示。若只是空白、资源加载失败，可以在官方支持的浏览器中，以同一账号做一次对照，记录差异；换浏览器不能解除账号或地区限制。
- “出了点问题”不等于已确定原因。 Google 将位置、年龄、账号类型等列为可能因素。保留发生时间与提示，稍后复查；持续出现时通过官方帮助反馈。
官方帮助中关于不同账号和受监护账号的说明可能随产品调整。本文不把“某个年龄以上一律可用”或“Family Link 一律不能用”作为通用结论，以当前账号收到的资格提示、对应帮助和管理员确认结果为准。
AI Studio 进不去、403 或跳到地区说明页
如果打开 AI Studio 后跳到了可用地区说明页，Google 官方说明是所在地区可能不受支持，这不是仅凭跳转就能确认的唯一原因。先查AI Studio 与 Gemini API 的当前地区列表，再核对具体访问条件。
AI Studio 排障页将年龄要求、账号验证、Workspace 管理和 Google Cloud 项目权限分别列出。该入口当前要求年满 18 周岁；这项要求不能直接套到 Gemini 网页聊天的所有账号。若页面要求年龄验证，请使用 Google 自己的验证入口；学校或组织账号由管理员确认资格。
| 实际现象 | 下一步核对 | 不要据此推断 |
|---|---|---|
| 403 Access Restricted | 查看完整提示，核对地区、资格、条款及账号或项目限制 | 所有 403 都是网络问题 |
| 能打开 Studio，但不能创建 API Key | 确认选中的项目，以及账号是否有管理 Key 所需的权限 | 能查看项目就拥有创建权限 |
| 已进入提示界面，但返回 No Content | 查看界面提供的阻止原因；用普通文本输入区分内容问题与访问问题 | 整个账号一定无法访问 |
修改后只验证原先失败的目标动作。例如原来无法创建 Key，就检查对应权限与创建结果；若目标是调用模型，还要继续验证生成请求，不能停在“Key 已创建”。
API 无法使用：看请求到了哪里，再读错误体
API 排障先记录服务商、项目、模型、协议与实际请求路径。Google 原生 API、Vertex AI 和第三方 OpenAI 兼容接口的认证与路径不能混用。路径拿不准时，先看《API 地址与协议对照》。
| 错误线索 | 优先核对 | 何时继续测试 |
|---|---|---|
| 400 / 参数不支持 | 请求字段、API 版本、模型是否支持该功能 | 去掉不适用参数或修正请求后 |
| 认证失败或 403 | Key 对应的服务与项目；完整错误是否指向权限、项目资格或计费 | 明确限制项并处理后，避免只反复重建 Key |
| 404 / 模型不存在 | 接口路径和当前可用模型名 | 确认目标资源存在并有权限后 |
| 429 | 错误体写的是短时速率还是额度耗尽 | 按等待时间或额度恢复条件处理，不无限重试 |
| 503 或临时服务异常 | 服务状态与同一请求的发生时间 | 服务恢复，或按提示进行有上限的退避重试 |
状态码只是分流线索，最终依据是该接口的错误体。Google 的API 错误参考列有不同错误类型；Gemini API 排障指南还特别说明：模型列表查询成功，不代表项目已经具备生成请求所需的资格或计费状态。
最小验证要与实际任务一致。 用目标模型发送一条无敏感信息的普通文本请求，检查是否有可用输出，并保留时间与请求记录。不要只看 HTTP 200 或 candidates 字段存在；空结果、生成被阻止和工具功能未实现仍需分别处理。图片、联网搜索、工具调用等能力在基础文本请求通过后，再逐项验证。
Gemini CLI 无法使用：把安装、认证和服务权益分开
gemini --version 都无法输出时，先检查安装与 PATH；能启动但认证失败，再记录当前 CLI 版本和认证方式。CLI 认证文档列有 Google 登录、Gemini API Key 和 Vertex AI，不应混合几套环境变量猜测哪套生效。
另一个容易混淆的变化是 Google 的2026 年 5 月 19 日迁移公告：6 月 18 日起，指定的消费端 CLI / Code Assist 服务权益停止处理请求，迁移方向为 Antigravity CLI；公告同时保留了企业许可证及付费 API 访问路径。这项变化不等于 Gemini 网页停止服务，也不等于所有 Google 账号登录方式全部失效。
截至 2026-10-26，认证文档仍包含个人 Google 登录说明，和上述迁移公告的表述并不完全一致。遇到权益相关报错时，记录账号方案、CLI 版本与完整提示，按当前账号界面及官方支持确认；本文不承诺某一类账号必定可用。API Key、自定义地址及历史版本配置见《Gemini CLI 接入与报错排查》。
还没解决时，留下这份脱敏排障记录
以下模板由云岚API整理，用于让支持人员知道失败发生在哪里。只填相关项，不粘贴 API Key、Cookie、授权头、完整邮箱或业务数据；请求域名和接口路径也要去掉查询参数中的凭据。
检查时间与时区：
入口：Gemini 网页 / AI Studio / API / Gemini CLI
地址或命令：仅保留域名、路径或不含凭据的命令
账号类型：个人 / 工作 / 学校 / 第三方服务账户
CLI / SDK / 浏览器版本（相关时填写）：
认证方式（不填密钥）：
服务商、项目别名与模型（相关时填写）：
失败阶段：页面加载 / 登录 / 选择项目 / 生成请求 / 工具调用
HTTP 状态与完整错误文案（脱敏后）：
已做的单项改动：
同一入口重新验证的结果：
请求 ID（如有）：
一次只改变一个条件，保留前后结果。比如更正模型名后同一条文本请求成功，才能说明这一处配置得到修正；同时换账号、网络、模型和接口，通常很难判断哪项生效。
常见问题
Gemini 网页进不去，换 API Key 有用吗？
API Key 用于相应服务的程序调用，不能更改 Gemini 网页账号的资格、组织设置或订阅权益。先确认问题是不是发生在 API 请求上，再决定是否检查 Key。
AI Studio 能打开，为什么 API 仍然失败？
网页访问、项目管理权限和模型调用是不同检查。应以目标项目的生成请求为准，结合错误体核对模型、权限、额度与计费，不能只凭页面能打开判断 API 正常。
换成第三方 API，能修好 Google 账号吗？
不能。第三方 API 提供的是另一条程序调用路径，不会恢复 Google 网页账号或 AI Studio 的使用资格。若实际目标是把模型接入自己的应用，应独立核对服务商的协议、模型、工具支持和费用。
云岚API用户下一步该检查哪里？
先在新业务站控制台核对当前分组、模型和接口，再按《新手接入教程》完成最小请求。旧站与新站的 Key 不通用；请求仍失败时，保留脱敏错误和请求记录，按《调用报错排查》继续处理。
核对日期：2026-10-26。依据为文中链接的 Google 官方帮助、Gemini API 文档、CLI 文档及迁移公告。入口对照、通过条件和记录模板为本站整理；未使用读者账号进行登录、付费或全功能测试。