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

Gemini API 接入教程

Google Gemini API 提供了强大的多模态 AI 能力，支持文本、图片、音频等多种输入类型。本文将详细介绍如何在 Python 项目中接入 Gemini API。

获取 API Key

首先访问 Google AI Studio (ai.google.dev)，注册账号后在控制台创建 API Key。免费版虽然免费，但数据可能会被 Google 用于模型训练，请勿在免费版 API 中发送敏感数据。

安装 Python SDK

使用 pip 安装 Google 官方库：

pip install google-generativeai

基础调用示例

使用 Google SDK 调用 Gemini API：

import google.generativeai as genai
genai.configure(api_key='your-api-key')
model = genai.GenerativeModel('gemini-pro')
response = model.generate_content('介绍一下 Python 的特点')
print(response.text)

OpenAI 兼容方式

Gemini 也支持 OpenAI 格式的兼容接口，方便开发者迁移：

from openai import OpenAI
client = OpenAI(
    api_key='your-api-key',
    base_url='https://generativelanguage.googleapis.com/v1beta'
)

国内开发者注意事项

由于网络限制，国内直接调用 Google 官方 API 可能会遇到连接问题。推荐使用国内中转服务，如一步 API 等平台，提供国内直连的 Gemini API 服务。如果你希望在一个平台中使用多个模型，bumo 是个不错的选择，它集成了 Gemini、Claude、OpenAI 等主流模型，无需单独配置每个 API。

多模态能力

Gemini 的优势在于多模态处理，可以同时处理文本和图片。例如：

import PIL.Image
img = PIL.Image.open('photo.jpg')
response = model.generate_content(['描述这张图片', img])

进阶使用

对于需要频繁切换模型或管理多个 API Key 的场景，bumo 提供了统一的接口和智能路由功能，帮你简化开发流程，提高调用效率。无论你是使用 Gemini、Claude 还是其他模型，都能在一个平台中轻松管理。