googleapis/python-genai

Google Gen AI SDK (python‑genai)

是什么 – 一个官方的 Python 客户端库，可调用 Google 的 Gemini 生成式 AI 模型（包括公开的 Gemini Developer API 和 Gemini Enterprise Agent Platform）。它处理认证、请求构建、流式传输、异步使用和响应解析，让您专注于提示词和结果。

核心功能

• 使用 API 密钥或企业凭证创建 genai.Client。
• 调用 client.models.generate_content(...) 从 Gemini 模型（如 gemini-flash-latest 或 gemini-3.1-pro-preview）获取文本、图像或视频。
• 支持同步和异步使用（Client().aio）。
• 灵活的输入：纯文本、types.Part 对象、文件上传或函数调用部分。
• 通过 Pydantic 模型或普通字典进行配置（例如 GenerateContentConfig、SafetySetting）。
• 自动函数调用（AFC）——传入 Python 可调用对象作为工具，让模型自动调用，并可选择禁用。
• 支持流式传输、实时传输和代理；可通过 aiohttp 选择快速异步客户端。
• 提供上下文管理器帮助，确保 HTTP 连接被正确关闭。

典型工作流程

from google import genai
from google.genai import types

client = genai.Client(api_key='YOUR_KEY')
response = client.models.generate_content(
    model='gemini-flash-latest',
    contents='为什么天空是蓝色的？',
    config=types.GenerateContentConfig(max_output_tokens=50)
)
print(response.text)
client.close()

适用人群 – 希望在应用程序、脚本或服务中集成 Gemini 的大语言模型功能（文本生成、图像生成、函数调用、安全控制等），但不想处理底层 HTTP 细节的 Python 开发者。

了解更多 – 完整文档请访问 https://googleapis.github.io/python-genai/，PyPI 页面，以及 README 中链接的 Gemini API 参考文档。