Google AI Studio 与 Gemini API 国内使用指南：密钥申请、区域不支持与调用超时全解

Google AI Studio 是试用 Gemini 模型最直接的入口：网页里选模型、调参数、写提示词，满意了点一下就能生成 API 密钥拿到代码里调用。免费额度对个人开发者相当友好，很多人把它当作接入大模型的第一站。但国内用户实际操作时会连续遇到几道墙：网页打开就提示所在区域不支持；账号能登录但生成密钥的按钮是灰的；密钥拿到了，代码里一调用就返回 403，错误信息写着 User location is not supported；有时请求发出去几十秒才超时。

这些现象对应四条不同的判定。网页那句区域提示看的是当前访问 IP；密钥按钮灰掉通常与账号区域或年龄状态有关；代码调用被拒看的是发请求那台机器的出口 IP，与浏览器的 IP 是两回事——这也是「网页能用、代码不能用」的根本原因；超时多半是命令行或服务端程序没走代理。这篇按四条线拆开，先跑通网页与密钥，再解决代码与服务端调用，最后说清免费额度与 Vertex AI 的区别。模型可用区域、免费额度与计费规则会不定期调整，以官方最新条款为准。

AI Studio、Gemini API 与 Vertex AI：三个入口先分清

看这张表要抓住一点：AI Studio 密钥与 Vertex AI 是两套独立体系。前者上手快、不用开 Cloud 项目，适合个人与原型；后者走 Google Cloud 的项目、计费与权限体系，区域可选、配额更高，适合正式产品。多数个人开发者从前者开始就够，调用量上来再迁。各档的额度与价格以官方最新条款为准。

把密钥申下来并跑通第一个请求：分步操作步骤

• 第一步：先把线路准备好，连上刺猬VPN。安装客户端后自定义用户名和密码即可完成匿名注册，不需要邮箱、也不需要手机号，免费节点永久免费、不限流量，注册即用；全程 HTTPS+AES 加密传输；
• 第二步：节点选支持区域，美国节点是最省事的选择。连上后打开 AI Studio，确认首页能加载出模型列表与对话框，不再出现区域提示；
• 第三步：用一个个人 Google 账号登录，账号需完成年龄验证；部分单位或学校的 Workspace 账号被管理员关闭了 AI 功能，会导致密钥按钮灰掉，换个人账号即可；
• 第四步：在 AI Studio 里先发一条对话确认模型能正常回复，再进入 API 密钥页面创建密钥，密钥只完整显示一次，立刻存进密码管理器；
• 第五步：在电脑上用命令行发第一个请求前，先给终端设置代理环境变量。多数命令行工具与 SDK 不读系统代理，需要显式设置 HTTPS_PROXY 指向客户端的本地端口；
• 第六步：用最简单的一条请求测试，比如让模型回一个字，确认返回 200 之后再接到自己的程序里；
• 第七步：服务端部署时，程序运行的那台机器必须自己能走支持区域的出口，本地能调不代表服务器能调；部署在海外的服务器通常直接可用，国内服务器需要在程序层配置代理；
• 第八步：把密钥放在环境变量或密钥管理服务里，不要写进代码提交到仓库；一旦泄露立刻在 AI Studio 里吊销并重新生成；
• 第九步：iPhone 用户要在手机上试 AI Studio，中国大陆区 App Store 不提供 VPN 类应用，需要用外区 Apple ID 下载客户端，完整步骤见 iOS 安装教程；一个账号支持多设备同时在线，开发机与手机可以共用同一套配置。

按现象逐条排查：网页、账号、密钥与调用

下面按你实际看到的提示逐条对应，先判断问题落在哪一层。

• 打开 AI Studio 提示所在区域不支持：浏览器 IP 不在支持区域，换到美国等支持区域的节点后刷新；
• 换了节点仍提示区域不支持：Cookie 里缓存了上次的判定，清站点数据后重新登录；
• 生成密钥按钮灰色不可点：账号未完成年龄验证，或 Workspace 管理员关闭了 AI 功能，换个人账号；
• 网页能对话、代码调用返回 User location is not supported：发请求的机器出口 IP 不在支持区域，给终端或程序配置代理；
• 调用返回 403 且提示 API key not valid：密钥复制少了字符，或密钥所属项目已删除，重新生成；
• 调用返回 429：触发每分钟或每日请求上限，加退避重试，或升付费档；
• 请求几十秒后超时无响应：程序根本没走代理，连接在半路被丢弃，检查环境变量是否在当前进程生效；
• 流式输出中途断开：长连接被中断，缩短单次生成长度或改用非流式；
• 本地能调、部署到服务器后不能调：服务器出口不在支持区域，在服务器程序层配置代理或部署到海外机器；
• 模型列表里没有某个新模型：新模型分区域分批开放，等待或在 Vertex AI 里选对应区域。

免费额度够不够用：几种用法的对比

免费额度的设计目标是试用与做原型，个人学习和小脚本基本够用；一旦要给别人用，请求量就不可控，及早绑定计费比在 429 里挣扎省心。API 调用以文本为主、流量很小，刺猬VPN 的免费节点通常足够，免费节点永久免费、不限流量、注册即用；如果同时还在传视频与图片给多模态模型、看教程，可以考虑时长套餐，期间不限流量、不限速。覆盖 20 多个国家、100 多台服务器，一个账号支持多设备同时在线。实际可用性取决于当前网络环境。

服务端与命令行的代理配置：本地能调不代表线上能调

这是国内开发者最容易反复踩的坑：浏览器里一切正常，本地脚本也能跑，一部署到服务器就全部 403。原因是浏览器与本地脚本走的是你电脑上的客户端出口，而服务器有自己的出口 IP。解决思路两种：把服务部署在支持区域的海外机器上直接调用；或者服务器留在国内，在程序层配置代理，让发往 Gemini API 的请求经过支持区域的出口。多数 HTTP 库与官方 SDK 都读 HTTPS_PROXY 环境变量，少数需要在初始化时显式传入代理参数。

命令行的情况类似，终端默认不继承系统代理，需要在当前会话设置环境变量或写进启动脚本。验证是否生效很简单：先请求一个显示出口 IP 的地址，看返回国家是不是支持区域，再调模型接口。合规边界也要说明：把密钥交给第三方中转方等于把调用数据也交了出去，涉及用户数据的产品要慎重；面向国内用户提供生成式 AI 服务还有相应的监管要求，不是网络层面能解决的。相关规则以官方最新条款为准。

和其他 AI 与开发工具的分工

AI Studio 解决的是模型调用，普通用户聊天的入口是 Gemini 应用，注册登录与稳定访问见 Google Gemini 使用指南。如果你同时接入了 OpenAI 或 Anthropic 的接口，密钥、计费与报错处理的逻辑很相似，可对照 OpenAI、Claude API 开发者调用指南。

在 Colab 里调 Gemini API 是常见组合，连接不上运行时与频繁断连的处理见 Google Colab 国内访问指南。把模型输出接到 Workers 等边缘函数上部署时，部署平台自身的访问问题见 Cloudflare 控制台与 Workers 国内访问。把网页试用、密钥、本地调用与线上部署四段分开处理，比一出 403 就怀疑密钥有效得多。

常见报错速查表

高频问答

• 问：网页能用为什么代码不能用？答：两者出口 IP 不同。浏览器走客户端出口，代码走的是运行那台机器的出口，给终端或程序配置代理即可；
• 问：免费额度有多少？答：按每分钟请求数、每日请求数与 token 数限制，个人学习够用，具体数字以官方最新条款为准；
• 问：AI Studio 密钥与 Vertex AI 选哪个？答：个人与原型用 AI Studio 密钥，正式产品与需要区域选择、合规控制的团队用 Vertex AI；
• 问：密钥泄露了怎么办？答：立刻在 AI Studio 吊销并重新生成，检查仓库历史里是否还留有旧密钥；
• 问：国内服务器能调 Gemini API 吗？答：需要在程序层配置代理让请求经过支持区域的出口，或把服务部署到海外机器；
• 问：调用 API 要多少流量？答：以文本为主，流量很小，免费节点通常足够；传视频与图片时才明显增加。

长期稳定使用 Gemini API：习惯与做法

Google AI Studio 打不开、区域不支持、密钥申请不了、调用超时，这些问题拆开看落在四层：浏览器 IP、账号状态、请求出口与代理配置。长期做法很明确——固定用支持区域的节点访问网页，用个人账号并完成验证，代理环境变量写进启动脚本，密钥放环境变量而不是代码，部署前先在服务器上验证出口 IP。

还有一条习惯：从第一天就给调用加上退避重试与用量统计，什么时候该升付费档心里有数。刺猬VPN 采用 HTTPS+AES 加密传输，支持自定义用户名和密码匿名注册，不需要邮箱和手机号；免费节点永久免费、不限流量、注册即用，调接口、看文档这类文本需求用免费节点就够，时长套餐按周月年计费、期间不限流量不限速，适合同时要传多模态素材与看教程的开发者，一个账号支持多设备同时在线。模型可用区域与计费规则会不定期调整，以官方最新条款为准，实际可用性取决于当前网络环境。