Google AI Studio API Key:完全设置指南(2026)
了解如何获取和使用 Google AI Studio API Key 来访问 Gemini 模型。涵盖免费额度、与 Vertex AI 的区别,以及 Python 和 Node.js 代码示例。
什么是 Google AI Studio?
Google AI Studio 是一个基于浏览器的 IDE,用于使用 Google 的 Gemini 模型构建生成式 AI 应用。它提供了一种快速、零配置的方式来原型化提示词、测试模型行为,并生成用于编程访问的 API Key。
与完整的云平台不同,Google AI Studio 的设计目标是让开发者在几分钟内从创意到第一次 API 调用。你可以实验不同的 Gemini 模型、调整温度和 token 限制等参数,并直接从界面导出可用的代码。
对于大多数想要使用 Gemini API 的开发者来说,Google AI Studio 是推荐的起点,尤其是那些还没有 Google Cloud 项目或不需要企业级基础设施的用户。
Google AI Studio 与 Google Cloud Vertex AI 的区别
Google AI Studio 和 Google Cloud Vertex AI 都提供对 Gemini 模型的访问,但面向不同的使用场景。Google AI Studio 为原型开发和设计,采用简单的 Key 认证和慷慨的免费额度。Vertex AI 是一个企业平台,提供基于 IAM 的访问控制、VPC 集成和高级计费管理。
如果你是个人开发者或小团队构建原型,Google AI Studio 是正确的选择。如果你要部署到有严格安全要求的生产环境,已有 GCP 基础设施,或需要更高速率限制,Vertex AI 更合适。
两个平台访问的是相同的底层 Gemini 模型——区别在于访问方式、计费和管理层。
访问 aistudio.google.com
要访问 Google AI Studio,在浏览器中打开 aistudio.google.com。你需要一个 Google 账号登录——你用于 Gmail、Google Drive 或 YouTube 的账号都可以。
Google AI Studio 在大部分地区可用。如果你所在的地区无法直接访问,可能需要使用 VPN。登录后你会看到仪表盘,可以创建提示词、与模型对话和管理 API Key。
界面语言为英文。在免费额度速率限制内,平台可免费用于开发。
如何获取 Google AI Studio API Key
从 Google AI Studio 获取 API Key 不到一分钟即可完成。登录后,整个过程完全在浏览器中操作,无需 CLI 或云项目配置。
- 第 1 步:访问 aistudio.google.com 并用 Google 账号登录
- 第 2 步:点击左侧栏菜单中的「Get API key」
- 第 3 步:点击「Create API key」按钮
- 第 4 步:如果你没有 Google Cloud 项目,系统会自动创建一个
- 第 5 步:复制生成的 API Key 并安全保存(例如存入环境变量)
Gemini API 免费额度(Google AI Studio)
Google AI Studio 为 Gemini API 提供了免费额度,足够用于开发、测试和小型项目。免费额度包括对所有可用 Gemini 模型的访问,包括 Gemini 2.5 Pro 和 Gemini 2.5 Flash。
免费额度有每分钟速率限制(大多数模型通常每分钟 15 次请求),但没有每日上限。这非常适合需要反复测试提示词和调整参数的迭代开发。
当你需要更高速率限制或准备投入生产时,可以在 Google Cloud 中启用计费升级到付费版。付费版按百万 token 计费,输入和输出 token 分别定价。支持的模型还提供提示缓存折扣。
在代码中使用 API Key
获取 API Key 后,就可以开始调用 Gemini API。Google 提供了 Python 和 JavaScript/TypeScript 的官方 SDK。你也可以直接使用 REST API 或 OpenAI 兼容端点。
以下是使用官方 Google Gen AI Python SDK 的最小示例:
from google import genai
client = genai.Client(api_key="YOUR_GOOGLE_AI_STUDIO_API_KEY")
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Explain what an API key is in one sentence."
)
print(response.text)使用 Google Gen AI Python SDK 调用 Gemini API
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "Explain what an API key is in one sentence.",
});
console.log(response.text);使用 Google Gen AI JavaScript SDK 调用 Gemini API
API Key 安全最佳实践
像对待密码一样对待你的 Google AI Studio API Key。永远不要将其提交到版本控制或硬编码在客户端代码中。将其存储在环境变量或密钥管理器中,开发和生产使用不同的 Key。
如果 Key 泄露,可以在 Google AI Studio 仪表盘中删除或重新生成。定期监控 API 使用量,以便发现可能表明 Key 泄露的异常增长。
常见问题
Google AI Studio 是免费的吗?
是的,Google AI Studio 提供免费额度,有每分钟速率限制但没有每日上限。免费额度足够用于开发、测试和小型项目。生产环境需要更高速率限制时,需要启用付费计费。
使用 Google AI Studio 需要 Google Cloud 账号吗?
不需要。你只需要一个普通的 Google 账号。生成 API Key 时,Google AI Studio 会自动为你创建 Google Cloud 项目,但你不需要手动设置或管理 GCP 项目。
可以用 OpenAI SDK 调用 Google AI Studio 的 API 吗?
可以。Google 为 Gemini API 提供了 OpenAI 兼容端点。将 base URL 设置为 Gemini 的 OpenAI 兼容端点,并使用 Google AI Studio API Key 作为 OpenAI SDK 中的 API Key 即可。
用 Google AI Studio API Key 可以访问哪些模型?
Google AI Studio API Key 可以访问所有可用的 Gemini 模型,包括 Gemini 2.5 Pro、Gemini 2.5 Flash 和 Gemini 2.5 Flash-Lite。同一个 Key 适用于所有模型,在 API 请求中指定模型名称即可。
免费额度的速率限制是多少?
免费额度通常允许大多数模型每分钟 15 次请求,没有每日上限。不同模型的速率限制可能有所不同。请查看官方文档获取最新限制。
本系列相关
相关供应商
参考来源
- Google AI StudioGoogle · 核验日期 2026-07-29
- Gemini API DocumentationGoogle AI for Developers · 核验日期 2026-07-29
- Gemini API PricingGoogle AI for Developers · 核验日期 2026-07-29
- Google Gen AI SDKGoogle AI for Developers · 核验日期 2026-07-29