使用教程

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

2025年12月18日阅读时间：10分钟预计阅读：5,234次

🎯 快速开始：本文将带你从零开始接入 Gemini API，包括官方渠道和国内中转站的使用方法。

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

🚀 Gemini API 中转站

国内用户专属福利！如果你在国内访问 Google API 遇到网络问题，推荐使用以下中转站：

推荐中转站： https://apipro.maynor1024.live/

✅ 国内直连，无需翻墙
✅ 兼容 OpenAI 格式
✅ 支持多模型切换（Gemini、GPT-4、Claude等）
✅ 提供免费试用额度
✅ 稳定可靠的访问速度

访问 API 中转站

第一步：获取 API Key

方法一：官方渠道申请

注意：使用官方 API 需要可以访问 Google 服务的网络环境。

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 并妥善保存

方法二：使用国内中转站

直接访问 https://apipro.maynor1024.live/ 注册并获取 API Key，无需翻墙即可使用。

第二步：环境配置

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

Python 环境配置

pip install -q -U google-generativeai

Node.js 环境配置

npm install @google/generative-ai

第三步：代码示例

Python 接入示例

使用官方 SDK

import google.generativeai as genai

# 配置 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)
            

使用中转站（OpenAI 兼容格式）

from openai import OpenAI

# 配置中转站
client = OpenAI(
    api_key="YOUR_PROXY_KEY",
    base_url="https://apipro.maynor1024.live/v1"
)

# 发送请求
response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "user", "content": "请用一句话介绍你自己"}
    ]
)

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

Node.js 接入示例

使用官方 SDK

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();
            

使用中转站（OpenAI 兼容格式）

const OpenAI = require('openai');

// 配置中转站
const client = new OpenAI({
    apiKey: 'YOUR_PROXY_KEY',
    baseURL: 'https://apipro.maynor1024.live/v1'
});

async function run() {
    const completion = await client.chat.completions.create({
        messages: [{ role: 'user', content: '请用一句话介绍你自己' }],
        model: 'gemini-2.5-pro',
    });

    console.log(completion.choices[0].message.content);
}

run();
            

价格与限制

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

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

中转站优势

对于国内开发者，直接使用 Google 官方 API 可能会遇到网络连接问题。使用国内的中转 API 具有以下优势：

✅ 国内直连：无需配置代理，访问速度快
✅ OpenAI 兼容：可以使用标准的 OpenAI SDK 调用 Gemini 模型
✅ 多模型支持：一个 Key 即可调用 Gemini、GPT-4、Claude 等所有模型
✅ 稳定可靠：专业的网络优化和故障转移机制

最佳实践建议

个人学习/测试场景

优先使用 Google 官方免费 API Key
适合学习和实验性质的项目
注意数据隐私保护

生产环境/商业部署

强烈推荐使用 API 中转站
获得更好的稳定性和访问速度
避免网络连接问题
提供专业的技术支持

🚀 立即开始使用 Gemini API

选择最适合您的接入方式，开始您的 AI 应用开发之旅

使用 API 中转站申请官方 API 查看示例代码

📚 相关文章推荐

Gemini 3 正式发布

Google Gemini 3 国内使用教程与功能评测

Gemini 镜像站推荐

国内访问 Gemini 的最佳方案

Gemini 功能详解

多模态、长上下文与代码能力全解析