Gemini 网页版、AI Studio 与 API：三个入口的可用条件不一样
网页版、AI Studio、API 是三条不同的路，各自看的东西不完全一样。搞清楚哪条通、哪条不通，比盲目换节点有用得多。
同一个 Google 账号、同一条线路，三种常见的困惑：
- 网页版打不开，AI Studio 却能用。
- AI Studio 里跑得好好的提示，用程序调就报错。
- 本机调用正常，部署到服务器上就失败。
这些都不是错觉。 网页版、AI Studio 与 API 是三条不同的路，各自看的东西不完全一样。搞清楚哪条通哪条不通，本身就是最有效的排查手段。
三个入口分别看什么
| 入口 | 主要看的东西 | 失败时的信息量 |
|---|---|---|
| Gemini 网页版 | 出口地址 + 账号属性 + 浏览器本地状态 | 最少，通常只有一句笼统提示 |
| Google AI Studio | 出口地址 + 账号属性（判断口径与网页版不完全相同） | 中等 |
| API / 程序调用 | 出口地址 + 项目与密钥配置 | 最多，报错通常指明原因 |
最有用的一条是最后一列。 网页版失败时往往只给一句「不可用」，你无从判断是地区、账号还是本地状态；API 调用失败时返回的信息通常具体得多，能直接告诉你是地区相关还是权限相关。
所以有一个反直觉但很实用的技巧：网页版打不开时，去用 API 调一次同样的东西，拿它的报错来诊断网页版的问题。 两者共享出口地址这一层，API 的报错能帮你把范围缩小一大截。
为什么 AI Studio 常常先能用
这是最常被问到的一组现象，原因不复杂：两个入口的判断口径不完全相同，并且它们面向的用户群不一样——AI Studio 更偏向开发和试验场景，网页版是面向一般用户的产品。
这个差别的实际用途不是「用 AI Studio 代替网页版」，而是把它当成一个诊断工具：
- AI Studio 能用、网页版不能 → 出口地址这一层大概率是通的。问题更可能在账号属性或浏览器本地状态上，去做无痕窗口和换账号的对照实验。
- 两个都不能用 → 出口地址这一层就有问题，优先换节点、查地址归属。
账号属性与出口地址怎么分开判断，见 Google 账号地区和节点地区是两回事。
本机调用和服务端调用面对的不是同一套判断
这一节针对把 Gemini 接进自己服务的人。
在自己电脑上跑通的调用，部署到服务器上失败，最常见的原因不在代码：
第一，出口地址完全换了。 你家里的出口是住宅宽带类型，云服务器的出口是数据中心地址段。后者在风控上天然处于不利位置，某些情况下比家用出口更容易被拦。「部署到海外就没问题了」这个预期经常落空，原因就在这里。
第二，服务器上的代理配置是另一套。 本机上你可能开着图形化的代理客户端，服务器上没有。命令行环境和运行时读的是环境变量，不读系统代理设置——这是「本机好好的、服务器上不通」的另一大来源。环境变量怎么配、怎么验证生效，见 Claude Code 与 API 在终端里连不上，那篇讲的方法对所有命令行场景通用。
第三，证书信任链不同。 服务器上的运行时用自己的信任库，缺少某些中间证书时会直接报握手失败，而浏览器因为自带管理不受影响。这类报错的分型见 TLS 握手错误怎么排查。
排查时把这三层拆开：先在服务器上单独确认出口地址的归属，再确认代理有没有生效，最后才看代码。顺序反了会浪费大量时间。
分清「地区问题」和「配置问题」
这是 API 场景特有的一个岔路，两条路的处理方向完全相反。
| 报错指向 | 典型特征 | 处理方向 |
|---|---|---|
| 地区相关 | 提示位置或地区不受支持 | 换出口地址、查账号属性 |
| 权限 / 配置相关 | 提示权限不足、服务未启用、密钥无效 | 查项目配置，与网络无关 |
| 配额相关 | 提示超出限制或速率过高 | 降低频率或调整配额，与网络无关 |
判断依据只有一条：换网络环境之后表现有没有变化。
- 换网络后报错消失或变化 → 地区相关。
- 换网络后报错一字不变 → 不在网络层，别再折腾节点了。
权限类问题通常出在三处：这个密钥对应的项目有没有启用相应服务、密钥有没有被限制在特定来源或接口范围、调用的接口和密钥类型是否匹配。这三处在本机和服务器上表现一致，这种一致性本身就是「问题不在网络层」的有力信号。
另外要提醒：付费与否和地区可用性是两个独立维度。 升级到付费通常影响的是配额、速率上限和可用模型范围，不会让一个不开放的地区变成开放。把配额问题误判成地区问题（或反过来）会白折腾很久。
按入口分别的排查顺序
网页版打不开
- 无痕窗口测一次，排除本地状态。
- 换账号不换网络、换网络不换账号，做两组对照。
- 打开 AI Studio 看能不能用，用它来判断出口地址这一层通不通。
- 确认是出口问题 → 查出口地址的归属国家与登记类型，换不同段的节点。
AI Studio 打不开
- 先确认网页版是不是也打不开——两个都不通指向出口地址。
- 确认浏览器里只登录了一个账号。多账号环境下的测试结论不可靠。
- 其余步骤同网页版。
API 调用失败
- 先读报错文本，按上一节的表分清是地区、权限还是配额。
- 地区相关 → 在调用发起的那台机器上单独确认出口地址归属。
- 权限相关 → 查项目与密钥配置，不要动网络。
- 排查阶段在代码里显式配置代理，而不是依赖系统代理——这能消除「到底走没走代理」这个不确定性，确认可用之后再决定长期运行方式。
什么情况下问题不在网络这一层
下面几种情况，继续换节点、换机场都不会有任何变化：
- 换了完全无关的网络环境后，报错一字不变。 这是最可靠的判据。
- 报错明确指向权限、服务未启用或密钥无效。
- 组织账号在个人账号正常的同一环境下不可用，说明是管理策略。
- 本机和服务器上表现完全一致，而两者出口地址不同。
反过来，这些情况值得在网络侧继续查：换网络后表现变化、出口地址归属一个未开放地区、出口地址被登记成数据中心类型、或者订阅里节点的实际落地与标注不符。
完整的地区报错分型与逐步排查见 Gemini 提示地区不支持怎么办；编辑器内 AI 工具的配置差异见 Cursor 与 GitHub Copilot 网络配置。