如何免费获取 Google Gemini API Key (2026)

如何免费获取 Google Gemini API 密钥 (2026)

Google 的 Gemini API 是目前最慷慨的免费 AI API 之一。其免费层级包括 Gemini 2.0 Flash 每天 1,500 次请求，并支持访问多种模型变体，对于构建 AI 应用的开发者来说，这是一个极佳的起点。本指南将带你完成获取免费 API 密钥并进行首次 API 调用的全过程。

免费版包含的内容

Google AI Studio 为 Gemini 模型提供免费 API 访问，具体限制如下：

模型	免费层级限制	频率限制 (Rate Limit)	上下文窗口
Gemini 2.0 Flash	1,500 次请求/天	15 RPM	1M tokens
Gemini 2.0 Flash-Lite	1,500 次请求/天	30 RPM	1M tokens
Gemini 1.5 Pro	50 次请求/天	2 RPM	2M tokens
Gemini 2.0 Flash Thinking	1,500 次请求/天	10 RPM	1M tokens

RPM = 每分钟请求数（requests per minute）。每日限制在太平洋时间午夜重置。

这些限制非常实用。凭借 Gemini 2.0 Flash 每天 1,500 次的请求额度，你可以免费构建并运行生产级应用——这是极少数 AI 供应商能提供的待遇。

第一步：访问 Google AI Studio

1. 打开浏览器并导航至 aistudio.google.com。
2. 使用你的 Google 账号登录。任何 Gmail 账号均可，无需特殊的开发者账号。
3. 你将进入 AI Studio playground，在这里可以以交互方式测试 Prompt。

第二步：生成 API 密钥

1. 点击左侧边栏（或顶部导航栏）的 "Get API Key"。
2. 点击 "Create API Key"。
3. 选择其中之一：
   • Create API key in new project（推荐新用户使用）
   • Create API key in existing project（如果你已有 Google Cloud 项目）
4. 复制生成的 API 密钥。它以 AIza... 开头。

# 将密钥存储为环境变量
export GEMINI_API_KEY="AIzaSy-your-api-key-here"

重要提示： 免费层级的 API 密钥无需设置结算信息即可使用。你不需要添加信用卡或在 Google Cloud 中启用计费。但是，免费层级的密钥会将你的数据纳入 Google 的模型改进计划中。对于注重数据隐私的生产环境使用，请考虑通过 Vertex AI 使用付费层级。

第三步：安装 SDK

Google 提供了针对 Python 和 JavaScript 的官方 SDK：

# Python
pip install google-genai

# JavaScript / Node.js
npm install @google/genai

第四步：进行首次 API 调用

Python 示例

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Write a Python function that implements binary search on a sorted list. Include type hints and docstring."
)

print(response.text)

JavaScript / Node.js 示例

const { GoogleGenAI } = require("@google/genai");

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Write a TypeScript utility type that makes all nested properties optional. Explain how it works.",
  });

  console.log(response.text);
}

main();

cURL 示例

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "Explain the CAP theorem with practical examples."}]
    }]
  }'

第五步：使用 OpenAI 兼容端点

Google 还提供了一个兼容 OpenAI 的端点，方便在已支持 OpenAI 格式的工具中使用：

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-2.0-flash",
    messages=[
        {"role": "system", "content": "You are a helpful coding assistant."},
        {"role": "user", "content": "Write a Redis caching middleware for Express.js."}
    ]
)

print(response.choices[0].message.content)

这种兼容性意味着你可以将免费的 Gemini API 密钥用于：

• Cursor（作为自定义 API 密钥）
• Continue.dev
• Aider
• LiteLLM
• 任何基于 OpenAI SDK 的应用程序

第六步：使用多模态功能

Gemini 天生具备多模态能力。你可以发送图像、音频、视频和文档：

分析图像

import base64

with open("screenshot.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents=[
        {"text": "Describe what you see in this screenshot and identify any UI/UX issues."},
        {
            "inline_data": {
                "mime_type": "image/png",
                "data": image_data
            }
        }
    ]
)

print(response.text)

分析 PDF 文档

with open("report.pdf", "rb") as f:
    pdf_data = base64.b64encode(f.read()).decode()

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents=[
        {"text": "Summarize the key findings in this report and list action items."},
        {
            "inline_data": {
                "mime_type": "application/pdf",
                "data": pdf_data
            }
        }
    ]
)

第七步：使用流式传输提升 UX

对于聊天应用，流式传输提供实时反馈感：

response = client.models.generate_content_stream(
    model="gemini-2.0-flash",
    contents="Write a comprehensive guide to database indexing strategies."
)

for chunk in response:
    print(chunk.text, end="", flush=True)

第八步：使用结构化输出

Gemini 支持 JSON 模式以实现结构化输出：

import json

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="List the top 5 JavaScript frameworks with their GitHub stars, license, and primary use case.",
    config={
        "response_mime_type": "application/json"
    }
)

data = json.loads(response.text)
for framework in data:
    print(f"{framework['name']}: {framework['stars']} stars")

免费层级优化技巧

简单任务使用 Flash-Lite。 Gemini 2.0 Flash-Lite 具有更高的频率限制（30 RPM 对比 15 RPM），在摘要、分类和简单代码生成方面表现出色。

缓存重复的上下文。 如果你反复发送相同的系统提示语或上下文，请使用 Gemini 的上下文缓存（context caching）功能来降低 token 使用量并减少延迟。

高效批量请求。 与其发送 10 个独立的 API 调用，不如考虑将相关工作合并到更少、更全面的请求中。

监控使用情况。 Google AI Studio 包含使用情况仪表盘。定期检查以确保你没有在不知情的情况下接近每日限额。

善用 1M 上下文。 Gemini 2.0 Flash 支持 100 万 token 的上下文。你可以通过单次请求传递整个代码库或文档，这比多次小规模请求更高效。

Gemini 免费版对比其他免费 AI API

功能	Gemini Free	OpenAI 免费额度	DeepSeek 免费版	Claude 免费版
每日请求限制	1,500	N/A (token 预算)	~2,000	N/A (频率限制)
最佳模型	Gemini 2.0 Flash	GPT-4o mini	DeepSeek-V3	Claude Sonnet
上下文窗口	1M tokens	128K tokens	64K tokens	200K tokens
多模态	是 (图像, 视频, 音频, PDF)	文本 + 图像	仅文本	文本 + 图像
需信用卡	否	否	否	否
兼容 OpenAI	是	原生支持	是	否
代码质量	良好	良好	优秀	优秀
有效期	永久免费层级	额度 3 个月过期	额度会过期	永久免费层级

Gemini 凭借其永久免费层级（无过期额度）、庞大的上下文窗口和多模态能力脱颖而出。

常见困扰

"API key not valid" 错误： 确保你复制了包含 AIza 前缀在内的完整密钥。末尾的空格也可能导致问题。

"Quota exceeded" 错误： 你已达到每日或每分钟的频率限制。请等待限制重置（每日限制在太平洋时间午夜重置，RPM 在 1 分钟后重置）。

响应不一致： 将 temperature 设置为 0 以获得确定性输出。默认的 temperature 会允许一定的随机性。

数据隐私问题： 免费层级的 API 调用可能被用于改进 Google 的模型。对于敏感数据，请使用 Vertex AI 的付费层级，它有更严格的数据处理政策。

常见问题解答

Gemini 免费层级真的是永久的吗？ Google 自发布 AI Studio 以来一直维持着免费层级。虽然细节限制可能会有所调整，但免费层版本身一直很稳定，目前没有取消的迹象。

我可以在生产环境中使用免费层级吗？ 可以，但请注意频率限制（Flash 为 15 RPM）和数据使用政策。对于处理用户数据的生产级应用，建议考虑付费的 Vertex AI 层级。

我需要 Google Cloud 账号吗？ 不需要。通过 AI Studio 使用免费层级，普通的 Google/Gmail 账号就足够了。只有使用付费的 Vertex AI 时才需要 Google Cloud。

我可以获得更多免费请求吗？ 创建一个 Google Cloud 项目并启用计费，可以获得更高的频率限制并按需付费。免费层版本身的限制无法直接增加。

哪个 Gemini 模型最适合编程？ Gemini 2.0 Flash 在免费层级上提供了速度与质量的最佳平衡。对于最复杂的编程挑战，Gemini 1.5 Pro（每天 50 次免费请求）提供了更好的推理能力。

总结

Google Gemini 的免费 API 层级可谓是 2026 年能玩到的最佳免费 AI API。每天 1,500 次请求、100 万 token 的上下文窗口、多模态支持以及 OpenAI 兼容性，使其成为原型开发和生产使用的绝佳选择。获取 API 密钥只需不到 2 分钟，你可以立即开始调用。

如果你的项目还需要 AI 生成媒体内容（如图像、视频或数字人分身），可以考虑在你的技术栈中添加媒体生成 API。

免费试用 Hypereal AI —— 35 积分，无需信用卡。