googleapis/python-genai

Google Gen AI Python SDK

简介 – 这是一个官方提供的 Python 客户端库，允许您调用 Google 的 Gemini 生成式 AI 模型（包括公开的 Gemini Developer API 和 Gemini Enterprise Agent Platform）。它将 REST 端点封装在便捷且具有类型的接口中，并处理身份验证、HTTP 传输和响应解析。

核心功能

• 使用 API 密钥（公开版 Gemini）或企业凭据（项目、位置）创建 genai.Client。
• 调用 client.models.generate_content 从 gemini-3.5-flash 或 gemini-2.5-flash 等 Gemini 模型获取文本、图像或视频。
• 提供纯字符串、字典或更丰富的 google.genai.types Pydantic 模型（例如 Part.from_text, Part.from_uri, Part.from_function_call）作为输入。
• 使用 GenerateContentConfig 配置生成参数（temperature、top-p/k、max tokens、安全设置、系统指令、响应模态等）。
• 使用自动函数调用：将 Python 可调用对象作为工具传递，模型即可调用它们；或者禁用此功能以接收显式的函数调用对象。
• 支持流式传输、异步调用（通过 client.aio）以及快速的 aiohttp 传输选项。
• 内置对代理、自定义基准 URL 和 API 版本选择（v1, v1alpha）的处理。
• 支持上下文管理器以实现自动资源清理，并提供显式的 close()/aclose() 方法。
• 用于列出模型、上传文件和设置安全设置的辅助工具。

典型用法

from google import genai
from google.genai import types

client = genai.Client(api_key="YOUR_GEMINI_API_KEY")
response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents=types.Part.from_text("Why is the sky blue?"),
    config=types.GenerateContentConfig(temperature=0, top_p=0.95),
)
print(response.text)

重要意义 – 它抽象掉了 Google Gemini API 的底层 HTTP 细节，提供了类型安全的请求构建，并集成了函数调用和安全控制等高级功能，使 Python 开发者能够更轻松地将最先进的生成式 AI 嵌入到应用程序、服务或研究笔记本中。

文档与安装

• Docs: https://googleapis.github.io/python-genai/
• Install: pip install google-genai (或 uv pip install google-genai)