Google AI Studio 打不开：Gemini API 可用地区与代理设置

AI Studio 的网络要求

Google AI Studio 是 Google 面向开发者的 Gemini 模型调试与 API Key 管理平台。它的可用性与 Gemini API 一致，取决于请求出口 IP 是否位于官方可用地区，同时也会参考 Google 账号关联的国家或地区。截至 2026 年 10 月，中国大陆和香港都不在 Gemini API 可用地区列表内，以官方列表为准。实际使用分两种场景：在浏览器里打开 AI Studio 调试提示词、创建 API Key，只需浏览器走支持地区节点；用代码调用 Gemini API，则需要为终端、IDE 或服务器单独配置网络。Gemini 应用（面向普通用户的聊天产品）的网络要求见 Gemini 网络环境与使用指南。

网页端与 API 的差异

推荐节点地区

本站对 AI Studio 推荐的节点地区与工具信息栏一致：

香港节点虽然延迟低，但不在可用地区内，不要用于 AI Studio 和 Gemini API。

为代码调用配置代理

在终端中设置代理后再运行代码（7890 为 Clash 系客户端常见默认混合端口，请以自己客户端为准）：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

# 验证能否访问 Gemini API 域名
curl -I https://generativelanguage.googleapis.com

Windows PowerShell 写法：

$env:HTTPS_PROXY="http://127.0.0.1:7890"

多数 HTTP 库和 SDK 会读取 HTTPS_PROXY 环境变量，但具体行为以所用 SDK 的文档为准。如果你在 Jupyter、IDE 中运行代码，请确认它们是从已设置变量的终端启动的，否则开启 TUN 模式更省事。更多终端代理写法见 终端代理设置。

常见报错与处理

地区相关问题的完整排查步骤可参考 Gemini 地区不可用怎么办。

AI Studio 与 Vertex AI 的区别

Google 提供两条使用 Gemini 模型的开发者路径，网络与地区规则不同：

如果你只是调试提示词、做个人项目，AI Studio 就足够；企业项目需要更完整的权限管理和合规要求时，再评估 Vertex AI。两者的具体规则都以 Google 官方文档为准。

检查出口与 Key 安全

• 检查出口：网页端可在浏览器中访问任意 IP 查询服务确认出口国家；终端中运行 curl -I https://generativelanguage.googleapis.com 只能确认可达，不能确认地区，地区问题以 API 返回的错误信息为准。
• Key 管理：为不同项目创建不同的 API Key，便于单独停用；不再使用的 Key 及时删除。
• 服务器部署：在 CI 或服务器中通过环境变量注入 Key，不要写进代码。

学习路径

1. 先阅读 Gemini 网络环境与使用指南，了解 Google 账号地区与出口 IP 的关系；
2. 按 终端代理设置 让终端、IDE 中的代码调用走代理；
3. 出现地区提示时，参考 Gemini 地区不可用怎么办 逐项排查。

请在遵守所在地法律法规与 Google 服务条款的前提下使用。