Gemini API 怎么接入？2026 年国内开发者完整接入教程

Gemini API 接入全攻略：从申请 Key 到第一次调用

Google Gemini API 是目前主流大模型 API 中多模态能力最强、免费额度最慷慨的服务之一。截至 2026 年 7 月，Gemini 已迭代到 3.5 Flash / 3.1 Pro 版本，支持文本、图片、音频和视频的统一处理。本文将手把手教你完成接入。

一、申请 API Key

1. 访问 Google AI Studio（aistudio.google.com），使用 Google 账号登录

2. 点击左侧菜单的「Get API Key」，选择「Create API Key」

3. 复制生成的 API Key 并妥善保存

免费额度方面：Gemini Flash 每天可调用 1,500 次，Pro 每天可调用 50 次，足够开发和测试使用。但注意，免费层的数据可能被用于模型改进，生产环境建议升级付费计划。

二、Python 快速接入

安装官方 SDK：

pip install google-genai

核心代码示例：

from google import genai
client = genai.Client()
response = client.models.generate_content(model='gemini-2.5-flash', contents='用三个词描述今天的编程心情')
print(response.text)

不传入 api_key 参数时，Client 会自动读取环境变量 GOOGLE_API_KEY。运行脚本后若能正常输出，说明接入成功。

三、国内直连方案

Google AI Studio 的 API 端点（generativelanguage.googleapis.com）在国内部分地区无法直连。解决方案有两种：

方案一：使用 API 聚合平台。通过支持 OpenAI 兼容协议的聚合服务，用 OpenAI Python SDK 即可调用 Gemini，模型 ID 格式为 google/gemini-2.5-pro，无需安装 Google 的 SDK，全球加速节点直连，延迟约 100-300ms。

方案二：使用 Google 提供的 OpenAI 兼容端点。Google 官方提供了 v1beta/openai 端点，可将现有 OpenAI SDK 代码迁移到 Gemini，主要改动包括 SDK 初始化、模型名称和响应格式解析。

如果你不想折腾网络配置和 SDK 安装，也可以直接使用 bumo AI 助手，它已经内置了 Gemini 及其他主流大模型的接入，打开浏览器就能和 Gemini 对话，支持长文档分析、代码生成等场景，免去了申请 Key 和配置代理的步骤。

四、模型选择建议

当前 Gemini 模型家族主要选项：

• Gemini Flash：$0.30/$2.50 每百万 Token（输入/输出），速度快、成本低，适合实时对话和简单任务
• Gemini Pro：$1.25/$10 每百万 Token，推理能力更强，适合复杂分析和长文档处理
• Gemini Flash-Lite：$0.10/$0.40，极致低成本，适合批量分类和摘要任务

Gemini 2.5 Pro 支持 100 万 Token 上下文窗口（约 75 万汉字），可以一次性处理整个代码仓库或长篇文档，这是它相比 Claude 和 GPT 的独特优势。

五、REST API 直接调用

除了 SDK，也可以用 curl 直接调用 REST API：

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/interactions' -H 'x-goog-api-key: $GEMINI_API_KEY' -H 'Content-Type: application/json' -d '{"model": "gemini-3.5-flash", "input": "Explain how AI works in a few words"}'

支持流式输出（SSE），只需在 URL 后加 ?alt=sse 参数即可。

与其他模型对比

根据 2026 年 3 月的对比数据：编程首选 Claude Sonnet 4.6（SWE-bench 79.6%）；超长文档分析首选 Gemini Pro（100 万上下文）；通用对话选 GPT-4o（生态最好）；低成本批量任务选 Gemini Flash-Lite。没有最好，只有最适合。

想要一站式体验和对比 Gemini、Claude、GPT、DeepSeek 等多种大模型的能力差异，推荐访问 bumo 官网，无需分别注册各平台账号，一个入口即可调用所有主流模型，快速找到最适合你场景的那个。