Google AI Studio 使用教程:创建 API Key 与解决地区限制
AI 工具 · 发布 2026-10-11 · 更新 2026-11-18 · 约 6 分钟读完
快速答案
Google AI Studio(aistudio.google.com)是 Google 面向开发者的 Gemini 模型调试平台,可免费试用并创建 Gemini API Key。国内访问需要代理,出口须在受支持地区;调用 API 时如果报 User location is not supported,说明请求从不受支持的地区发出,需要让代码也走代理。
目录
Google AI Studio 是什么、国内能不能用访问 AI Studio 的网络设置创建 Gemini API Key 的步骤在代码中调用 Gemini API 时配置代理常见报错与解决免费额度与付费计费节点稳定性建议适合开发者的机场小结常见问题Google AI Studio 是什么、国内能不能用
Google AI Studio 是 Google 提供的网页版开发者工具,地址是 aistudio.google.com。它可以:
- 直接在网页上和最新的 Gemini 模型对话、调整参数、测试系统提示词;
- 上传图片、音频、视频和长文档,测试多模态能力;
- 一键创建 Gemini API Key,并生成 Python、JavaScript、curl 等示例代码。
它和面向普通用户的 Gemini App 不同:AI Studio 更偏开发和调试,提供较为宽松的免费额度(具体额度和条款以官方为准)。国内用户可以使用,但需要满足:网络通过代理访问、出口在受支持地区(香港不在其中)、使用符合条件的 Google 账号。如果你只是想日常聊天,直接看 Gemini 国内怎么用 即可。
访问 AI Studio 的网络设置
AI Studio 的网页本身托管在 Google 域名下,API 请求则发往 generativelanguage.googleapis.com。需要保证这两类域名都走同一个受支持地区的节点:
| 域名 | 用途 | 建议 |
|---|---|---|
| aistudio.google.com | 网页控制台 | 走美国 / 日本 / 新加坡节点 |
| generativelanguage.googleapis.com | Gemini API 接口 | 与上面同一节点 |
| accounts.google.com | 账号登录 | 与上面同一节点 |
很多机场的默认规则会把 Google 服务分给“香港优先”的策略组,这对 AI Studio 不适用。可以在分流规则中把上述域名单独指向 AI 策略组,写法见 分流规则教程。
创建 Gemini API Key 的步骤
- 确认客户端已连接受支持地区节点,浏览器访问 aistudio.google.com 并登录 Google 账号;
- 首次进入需要同意服务条款;
- 点击左侧或顶部的“Get API key”;
- 选择“Create API key”,可新建一个 Google Cloud 项目或选择已有项目;
- 复制生成的 Key,妥善保存,不要提交到公开的代码仓库。
在代码中调用 Gemini API 时配置代理
网页能打开不代表代码也能调通。Python、Node.js 程序默认不会使用系统代理,需要显式设置。最通用的方法是环境变量:
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export GEMINI_API_KEY=你的Key
python main.py
Google 官方的 Python SDK(google-genai)底层使用的 HTTP 库一般会读取 HTTPS_PROXY 变量。Node.js 的原生 fetch 在不同版本中对环境变量代理的支持不一致,如果设置后仍不生效,最简单的办法是开启客户端的 TUN 模式,让所有进程的流量都被接管。
用 curl 快速测试连通性:
curl -x http://127.0.0.1:7890 "https://generativelanguage.googleapis.com/v1beta/models?key=你的Key"
返回模型列表说明网络和 Key 都正常。终端代理的更多细节见 终端 / git / npm 代理设置。
常见报错与解决
| 报错 | 原因 | 处理 |
|---|---|---|
| User location is not supported for the API use | API 请求的出口 IP 在不受支持地区(香港、中国大陆) | 确认代码走了代理,且节点在美国、日本等地区 |
| AI Studio is not available in your country | 网页访问出口地区不受支持,或账号地区限制 | 换节点、清缓存,检查 Google 账号关联国家 |
| API key not valid | Key 复制错误、被删除或项目未启用 API | 重新复制或新建 Key |
| 429 RESOURCE_EXHAUSTED | 免费额度或速率达到上限 | 降低请求频率,或为项目开通计费 |
| 连接超时 / ECONNRESET | 程序没有走代理 | 设置 HTTPS_PROXY 或开 TUN |
| 频繁 reCAPTCHA | 节点 IP 信誉差 | 换节点,参考 Google 人机验证 |
免费额度与付费计费
AI Studio 和 Gemini API 有免费层级,适合学习和小规模测试,但存在速率和每日请求次数限制;免费层的输入输出数据可能被用于改进 Google 产品,这一点在官方条款中有说明,处理敏感数据时应注意。为项目绑定 Google Cloud 结算账号后进入付费层级,限额更高,数据处理条款也不同。具体价格和限额随模型变化较快,以官方定价页为准。
如果你在服务器上部署调用 Gemini API 的应用,服务器的 IP 也必须在受支持地区;国内服务器需要配置代理或改用海外服务器。
节点稳定性建议
- 调试长上下文或视频理解时,单次请求可能持续较久,节点不稳定会导致请求中断;
- 把 Google AI 相关域名放在手动选择的策略组,固定一个节点,不要使用自动测速;
- 避免和 YouTube 等流媒体共用“香港优先”的策略组;
- 上传大文件时会消耗较多流量,大量测试多模态时注意套餐余量。
更多地区选择逻辑见 AI 工具该选哪个节点 和 美国节点。
适合开发者的机场
开发者通常同时调用多家 AI 接口,选机场时重点看:美国 / 日本 / 新加坡节点是否齐全、线路是否为专线、是否支持 Clash 规则自定义。本站收录的 速界 品牌资料重点强调 ChatGPT、Claude、Gemini 场景;光年梯 月付 18 元 110GB、IEPL 专线 + VLESS,品牌资料显示支持常见 AI 场景。以上均为品牌资料描述,实际可用性受节点 IP、地区和平台策略影响。更多见 AI 专用机场推荐。
小结
Google AI Studio 是免费试用 Gemini 模型和获取 API Key 最直接的入口。国内使用时,网页和代码都要走受支持地区的代理;报 User location is not supported 时,先检查程序是否真正走了代理。需要一条稳定的开发线路,可以从 机场推荐总榜 开始比较。
常见问题
Google AI Studio 免费吗?
有免费层级,可以在网页上测试模型并创建 API Key,但有速率和次数限制;绑定结算账号后进入付费层级。
调用 Gemini API 报 User location is not supported 怎么办?
说明请求从不受支持的地区发出。确认程序走了代理且节点在美国、日本等地区,必要时开启 TUN 模式,见 TUN 模式详解。
AI Studio 和 Gemini App 有什么区别?
AI Studio 面向开发者,可调参数并创建 API Key;Gemini App 面向普通用户日常对话,见 Gemini 国内怎么用。
国内服务器能调用 Gemini API 吗?
服务器出口必须在受支持地区。国内服务器需要配置代理,或改用海外服务器部署。
Gemini API Key 泄漏了怎么办?
立即在 AI Studio 或 Google Cloud 控制台删除该 Key 并重新生成,同时检查项目的用量和账单。
AI 工具 · 继续阅读
ChatGPT 国内怎么用:从网络环境、节点选择到账号注册
中国大陆不在 OpenAI 的服务地区内,需要先通过代理把出口切到受支持的地区(美国、日本、新加坡、台湾等,避开香港),再用邮箱或 Google / 微软 / Apple 账号注册登录;日常使用尽量固定一个节点,配合规则模式或 TUN 模式,即可稳定访问网页版、App 和 API。
ChatGPT Plus 怎么开通:官方付款渠道、费用与注意事项
ChatGPT Plus 只能通过官方渠道开通:网页端绑定 OpenAI 支持的银行卡付款,或在受支持地区的 App Store / Google Play 应用内订阅。开通前先固定一个受支持地区的节点,账单地址与节点地区尽量一致;第三方代充和共享账号存在封号、退款和隐私风险,不建议使用。
Claude 国内怎么用:网络环境、注册验证与账号防封
Claude 不向中国大陆和香港提供服务,国内使用需要把网络出口固定在美国、日本、英国等受支持地区;注册时可能需要受支持地区的手机号验证。Claude 对 IP 变动和共享 IP 比 ChatGPT 更敏感,建议使用干净的固定节点、开启 TUN 模式防 DNS 泄漏,并且不要多人共用账号。
Claude Code 安装与代理配置:从安装到 HTTPS_PROXY 设置
Claude Code 可通过官方安装脚本或 npm 安装,登录需要 Claude Pro / Max 账号或 Anthropic API Key。国内使用的关键是让终端走代理:设置 HTTPS_PROXY / HTTP_PROXY 环境变量,或直接开启客户端 TUN 模式,并把出口固定在美国、日本等受支持地区。
OpenAI Codex 使用教程:CLI、IDE 插件与云端任务
Codex 是 OpenAI 的编程智能体,有命令行(Codex CLI)、IDE 插件和 ChatGPT 网页里的云端版本。国内使用需先让终端走代理(设置 HTTPS_PROXY 或开 TUN 模式),出口固定在美国、日本等受支持地区,然后用 ChatGPT Plus 及以上账号或 API Key 登录。
Gemini 国内怎么用:Google 账号、节点地区与常见问题
国内使用 Gemini 需要一个 Google 账号和受支持地区的网络出口(美国、日本、新加坡、台湾等,香港不行)。如果节点没问题仍提示地区不支持,往往是 Google 账号的“关联国家”被判定为中国或香港,需要检查账号的国家/地区设置。