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

Gemini API 接入指南：从零开始调用 Google 大模型

Google Gemini API 是目前主流大模型 API 中免费额度最慷慨的之一。通过 Google AI Studio，开发者可以免费获取 API Key，Flash 模型每天可调用 1500 次，Pro 模型每天 50 次。本文将带你从零完成 Gemini API 的接入。

第一步：获取 API Key

1. 访问 Google AI Studio 官网（ai.google.dev），使用 Google 账号登录。

2. 进入控制台后，点击左侧导航栏的 Get API Key，选择 Create API Key。

3. 复制生成的 API Key，妥善保存。注意：切勿将 Key 硬编码在代码中或提交到 Git 仓库。

第二步：安装 Python SDK

Google 推荐使用统一的新版 google-genai SDK（2025 年发布，替代旧版 google-generativeai）：

pip install google-genai

安装完成后，即可在 Python 项目中导入使用。

第三步：发送第一次请求

以下是一个最简单的文本生成调用示例：

from google import genai
client = genai.Client(api_key='你的API_KEY')
response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents='用三句话解释什么是人工智能'
)
print(response.text)

如果一切正常，你将看到 Gemini 返回的三句话回答。截至 2026 年 8 月，最新的 Flash 模型名称为 gemini-3.5-flash，Pro 模型为 gemini-3.5-pro。

第四步：处理速率限制

免费层级的速率限制为：Flash 每分钟 15 次请求，Pro 每分钟 2 次。遇到 429 错误时，推荐使用指数退避重试策略。Python 的 tenacity 库是处理此场景的利器：

from tenacity import retry, stop_after_attempt, wait_exponential

@retry(stop=stop_after_attempt(5), wait=wait_exponential(min=2, max=60))
def call_gemini(prompt):
    return client.models.generate_content(
        model='gemini-3.5-flash',
        contents=prompt
    )

第五步：从 OpenAI 迁移

如果你之前使用 OpenAI API，Google 提供了一个 OpenAI 兼容端点（v1beta/openai），可以在几乎不改代码的情况下切换到 Gemini。主要差异在于 SDK 初始化方式、模型名称和响应格式解析。

不想写代码？直接在线体验

如果你只是想快速体验 Gemini 的能力而不想配置开发环境，可以访问 bumo AI 助手平台，直接在浏览器中使用 Gemini、Claude、DeepSeek 等模型，无需注册 API Key，开箱即用。

总结

Gemini API 的接入流程非常简单：注册 AI Studio 获取 Key，安装 SDK，几行代码即可调用。免费额度适合开发测试，生产环境建议升级付费计划以获得更高的速率限制和更稳定的服务。

对于不想折腾 API 接入的用户，推荐直接使用 bumo 在线 AI 对话工具，多模型一键切换，省时省力。