Google AI Studio 使用教程:创建 API Key、地区限制与代理设置(2026)

Google AI Studio 上手教程:如何进入 AI Studio 测试 Gemini 模型、创建 Gemini API Key、在代码中调用 API,以及地区限制、终端与程序走代理的设置方法。

快速答案

Google AI Studio 是 Google 面向开发者的 Gemini 模型测试平台,用 Google 账号登录后可以直接试用模型并创建 API Key。它的地区限制比 Gemini 网页版更严格,建议固定美国节点;在代码里调用 API 时,还需要让程序走代理。

核心结论

  • 用 Google 账号登录 AI Studio,即可免费试用模型
  • 在 AI Studio 里创建 API Key,用于代码调用
  • 地区限制更严格,固定美国节点最稳妥
  • 程序调用 API 需要 TUN 模式或环境变量代理

AI Studio 是什么

Google AI Studio 是 Google 给开发者用的 Gemini 模型平台。你可以在网页里直接测试各个模型、调整参数,也可以一键创建 API Key,把 Gemini 接入自己的程序。普通聊天使用 Gemini 网页版即可,见 Gemini 使用教程。

入口与文档

以上均为 Google 官方渠道。不要从网盘、论坛或搜索广告下载“破解版”“加速版”安装包。 官方支持地区列表。

登录与试用模型

  1. 开启代理并固定美国节点;
  2. 打开 AI Studio,用 Google 账号登录;
  3. 首次进入按提示同意服务条款;
  4. 在对话界面选择模型,输入问题即可测试。

创建 API Key

  1. 在 AI Studio 中找到 API Key 相关入口;
  2. 点击创建,按提示选择或创建一个项目;
  3. 复制生成的 Key,妥善保存。

在代码中调用:让程序走代理

用 SDK 或 HTTP 请求调用 Gemini API 时,请求来自你的程序,而不是浏览器,所以需要单独走代理。

方式一:开启 TUN 模式(推荐)。 所有程序自动走代理,无需改代码。

方式二:运行程序前设置环境变量。 端口以代理客户端实际显示为准:

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

大多数主流 HTTP 库和官方 SDK 会读取这两个环境变量。部署到海外服务器上的程序则不需要代理。

常见问题

网页版 Gemini 能用,AI Studio 不能用

AI Studio 的可用地区比 Gemini 网页版更少,换到美国节点通常可以解决。

调用 API 提示地区不支持

请求的出口 IP 不在支持地区。确认程序确实走了代理,并且代理节点是美国。

常见问题

Google AI Studio 打不开或提示不可用?

多数是节点地区或 Google 账号地区不受支持。固定美国节点,确认账号地区设置,再清理 Cookie 后重新登录。

API Key 创建好了,代码里调用报网络错误?

程序运行在终端或服务端,不会自动走浏览器代理。开启代理客户端的 TUN 模式,或在运行程序前设置 HTTPS_PROXY 环境变量。

API Key 泄露了怎么办?

立刻在 AI Studio 里删除这个 Key 并重新创建。不要把 Key 写进公开的代码仓库。