Gemini API 怎么接入？2026年最新 Python 调用教程与国内使用方案

Gemini API 是什么？

Gemini API 是 Google 提供的大语言模型接口服务，支持文本、图像、音频和视频的多模态处理。截至2026年，Gemini 已迭代至 3.x 系列，其中 Gemini Flash 定价低至每百万 Token $0.075 输入，是主流 AI API 中价格最低的之一。Gemini Pro 支持 100 万 Token 的超长上下文窗口，适合代码库分析、长文档摘要等场景。

第一步：获取 Gemini API Key

访问 Google AI Studio（ai.google.dev），登录 Google 账号后即可在控制台创建 API Key。Google 为开发者提供了免费额度：Gemini Flash 每天可调用 1500 次，Gemini Pro 每天可调用 50 次，足够用于开发测试。但注意，免费层级的数据可能被用于模型改进，生产环境建议升级付费方案。

第二步：安装 Python SDK 并调用

安装 Google 官方 SDK：pip install google-genai。以下是最新调用示例：

from google import genai

client = genai.Client(api_key='你的API_KEY')

response = client.interactions.create(model='gemini-3.5-flash', input='解释AI的工作原理')

print(response)

返回结果中包含 usage 字段，可查看本次调用的 Token 消耗情况，方便做成本核算。

国内开发者怎么接入？

Google AI Studio 的 API 端点 generativelanguage.googleapis.com 在国内部分地区无法直连。解决方案有两种：一是通过 API 聚合平台调用，全球加速节点直连，延迟通常在 100-300ms，无需额外网络配置；二是使用 OpenAI 兼容协议，用 OpenAI Python SDK 即可调用 Gemini，模型 ID 格式为 google/gemini-3.5-pro。

Google 官方也提供了 OpenAI 兼容端点，迁移时主要需要修改 SDK 初始化方式、模型名称和响应格式解析，整体改动量不大。

Gemini Flash 和 Pro 怎么选？

Flash 定价 $0.075/$0.30 每百万 Token，速度快、成本低，适合实时对话和简单任务；Pro 推理能力更强，适合复杂分析和长文档处理。预算敏感场景还可考虑 Flash-Lite（$0.10/$0.40）。如果你需要在一个界面里同时使用 Gemini、Claude、GPT 等多种模型并对比效果，bumo 多模型平台支持一键切换，无需为每个模型单独配置环境。

免费额度与速率限制

免费层级速率限制为：Flash 15 次/分钟，Pro 2 次/分钟。付费层级提升至：Flash 2000 次/分钟，Pro 1000 次/分钟。企业版可申请更高配额。建议在开发阶段充分利用免费额度验证接口逻辑，上线后再切换付费方案。

如果你不想处理复杂的网络配置和 Key 管理，直接访问 chat.bumo.cc 即可在国内网络环境下快速体验 Gemini 的最新模型能力，省去翻墙和配置的烦恼。

总结

Gemini API 接入并不复杂，核心就是获取 Key、安装 SDK、调用接口三步。对于国内开发者，通过聚合平台是最省事的方案。选择 Flash 还是 Pro，取决于你的任务复杂度和预算。