Gemini API开发指南：免费申请API Key与Python/Node.js接入教程

Google Gemini 提供了强大的 API 接口，允许开发者将其多模态能力集成到自己的应用程序中。目前，Google AI Studio 为开发者提供了慷慨的免费额度。本文将带你从零开始接入 Gemini API。

体验 Gemini 请从 Google 官方网页版 进入；开发者可使用 Google AI Studio 与 Gemini API 文档。具体模型、地区支持和额度以官方页面及账户显示为准。

第一步：获取 API Key

1. 访问 Google AI Studio 打开网址：https://aistudio.google.com/ （需使用美国等支持地区的 IP 访问）。

2. 登录 Google 账号 使用你的 Google 账号登录。

3. 创建 API Key

   • 点击左侧菜单的 “Get API key”。
   • 点击 “Create API key” 按钮。
   • 选择 “Create API key in new project”（在新项目中创建）。
   • 复制生成的 API Key 并妥善保存。

第二步：环境配置

Gemini 提供了官方的 Python 和 Node.js SDK，也可以通过 REST API 调用。

Python 环境

pip install -q -U google-generativeai

Node.js 环境

npm install @google/generative-ai

第三步：代码示例

Python 接入示例

import google.generativeai as genai
import os

# 配置 API Key
genai.configure(api_key="YOUR_API_KEY")

# 选择模型
model = genai.GenerativeModel('gemini-2.5-pro')

# 发送文本消息
response = model.generate_content("请用一句话介绍你自己")
print(response.text)

# 多模态输入（文本 + 图片）
# img = PIL.Image.open('image.jpg')
# response = model.generate_content(["这张图片里有什么？", img])
# print(response.text)

Node.js 接入示例

const { GoogleGenerativeAI } = require("@google/generative-ai");

// 初始化
const genai = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genai.getGenerativeModel({ model: "gemini-2.5-pro" });

async function run() {
  // 发送文本
  const prompt = "请用一句话介绍你自己";
  const result = await model.generateContent(prompt);
  const response = await result.response;
  const text = response.text();
  console.log(text);
}

run();

价格与限制

目前 Google AI Studio 提供两种计费模式：

特性	免费版 (Free of Charge)	付费版 (Pay-as-you-go)
RPM (每分钟请求数)	15	360+
TPM (每分钟 Token 数)	32,000	2,000,000+
每日请求限制	1,500	无限制
数据隐私	数据可能用于改进模型	数据不会被用于训练

注意：免费版虽然免费，但数据可能会被 Google 用于模型训练，请勿在免费版 API 中发送敏感个人数据或商业机密。

替代方案：聚合 API

中转 API 或聚合 API 是独立第三方服务。不要把官方 API Key、生产凭据或含有敏感信息的请求发送到未经核实的域名。

第三方镜像站或聚合平台属于独立服务，不能仅凭名称、界面或模型标签确认其接入了 Google 官方 API，也不能据此认定与官网功能和输出质量一致。

• 核实来源：确认运营主体、服务条款、模型来源说明和客服渠道，无法核实的服务不宜用于正式业务。
• 核实数据处理：检查提示词、附件和日志交由谁保存、保存多久、是否用于训练及能否删除。使用非敏感测试数据。
• 核实功能：逐项确认文件大小、上下文、图像、语音、工具调用和速率限制，不把 Google 的模型规格直接当作第三方套餐权益。
• 核实费用：确认计费单位、限流、自动续费、退款及停服条款，避免大额预付或共享账号、代充交易。

体验 Gemini 请从 Google 官方网页版 进入；开发者可使用 Google AI Studio 与 Gemini API 文档。具体模型、地区支持和额度以官方页面及账户显示为准。

如需兼容其他接口格式，请先核对 Gemini API 官方文档 的支持方式；测试时使用环境变量保存凭据，设置预算和配额，并在服务端调用。

总结

体验 Gemini 请从 Google 官方网页版 进入；开发者可使用 Google AI Studio 与 Gemini API 文档。具体模型、地区支持和额度以官方页面及账户显示为准。生产环境应审查数据处理条款、密钥权限、预算和故障恢复方案，不能把第三方中转默认当成更稳定或更安全的方案。