Gemini API 怎么接入？2026 Python SDK 快速上手教程

Gemini API 怎么接入？完整教程

Google Gemini API 是开发者接入 Gemini 大模型的最快路径。截至 2026 年，Gemini 2.5 Pro 支持 100 万 token 的上下文窗口，适合长文档分析、代码库处理等场景。本文带你从零完成 API 接入。

第一步：获取 API Key

访问 Google AI Studio（aistudio.google.com），登录 Google 账号后点击「Get API Key」即可生成密钥。免费额度为：Gemini Flash 每天 1,500 次请求，Gemini Pro 每天 50 次请求，适合开发测试。生产环境建议使用付费方案，因为免费层有速率限制且数据可能被用于模型改进。

第二步：安装 Python SDK

pip install google-genai

Google 在 2025 年推出了统一的 google-genai SDK，替代了旧的 google-generativeai，同时支持 AI Studio 和 Vertex AI 两种端点。

第三步：编写第一段调用代码

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-2.5-flash',
    contents='用一句话解释什么是量子计算'
)
print(response.text)

运行脚本后能正常输出文本，说明你的 Gemini API 链路已打通。

模型选择与定价参考

• Gemini 2.5 Flash：$0.30/$2.50 每百万 token，速度快、成本低，适合实时对话和简单任务。
• Gemini 2.5 Pro：$1.25/$10 每百万 token（≤200k token），推理能力强，适合复杂分析和长文档处理。
• Gemini Flash-Lite：$0.10/$0.40，预算敏感场景的最佳选择。

国内直连注意事项

Google AI Studio 的 API 端点（generativelanguage.googleapis.com）在部分国内网络环境下无法直连。开发者可以通过 API 聚合平台或代理服务接入，延迟一般在 100-300ms。

如果你不想处理网络配置和 SDK 安装这些繁琐步骤，bumo 提供了开箱即用的 AI 对话体验，内置 Gemini、Claude、GPT 等主流模型，打开网页就能用，无需任何开发配置。

OpenAI 兼容模式

Google 还提供了 OpenAI 兼容端点（v1beta/openai），可以用现有的 OpenAI Python SDK 直接调用 Gemini，只需修改 base_url 和模型名称，大幅降低迁移成本。这对已经用 OpenAI SDK 构建了应用的开发者非常友好。

速率限制与重试策略

免费层 Flash 为 15 次/分钟，Pro 为 2 次/分钟。付费第一层 Flash 提升至 2,000 次/分钟，Pro 为 1,000 次/分钟。遇到 429 错误时，建议使用指数退加重试策略，例如 Python 的 tenacity 库。

小结

Gemini API 以超长上下文窗口和极具竞争力的定价，成为 2026 年 AI 开发者的重要选择。对于非开发者用户，直接使用 bumo AI 助手平台 是最省事的方式，无需编写代码即可体验 Gemini 的强大能力。