Google Gen AI Python SDK

什么是 Google Gen AI Python SDK？

Google Gen AI Python SDK 是一个用于将 Google 生成式模型集成到应用中的 Python 客户端库。它支持 Gemini Developer API 与 Gemini Enterprise Agent Platform API，为开发者提供统一的客户端接口，用于配置访问方式和发送模型请求。

该软件包的安装名称为 google-genai，通过 google.genai 导入。文档介绍了客户端创建、generate_content() 等模型操作、通过 google.genai.types 构造类型化请求，以及使用 API 密钥或企业项目设置进行配置。API 方法输入既支持 Pydantic 对象，也支持字典。

该 SDK 面向使用 Google 生成式 AI 服务构建 Python 应用的开发者。文档还介绍了异步客户端的使用和显式客户端清理；同时，代码仓库提示，部分自动函数调用和方法接口将在未来主要版本中发生变化。

Google Gen AI Python SDK 能做什么？

支持两类 Google Gen AI 服务

可为 Gemini Developer API 或 Gemini Enterprise Agent Platform API 创建客户端：前者使用 API 密钥，后者使用企业项目和位置进行配置。

生成模型内容

使用选定的模型以及文本或类型化内容调用 `client.models.generate_content()` 等模型操作，代码仓库中的 Python 示例展示了这种用法。

支持类型化输入和字典输入

使用 `google.genai.types` 中的 Pydantic 类型构造结构化请求；如果更便捷，也可以传入字典。

基于环境的配置

使用环境变量配置客户端，包括用于 Gemini Developer API 的 `GEMINI_API_KEY` 或 `GOOGLE_API_KEY`，以及用于 Agent Platform 的企业项目设置。

同步和异步客户端

文档展示了标准客户端用法，以及通过客户端 `aio` 接口使用异步客户端，适用于需要异步调用的应用。

显式释放资源

可以显式关闭同步和异步客户端，以便应用完成使用后释放底层 HTTP 连接及相关资源。

使用场景

“将模型生成能力加入 Python 应用”

使用已配置的客户端和 `generate_content()`，从应用代码向 Google 生成式模型发送提示词或类型化内容。

“快速验证 Gemini 驱动的功能”

使用 `pip` 或 `uv` 安装软件包，利用 API 密钥创建 Developer API 客户端，在无需构建自定义 HTTP 集成的情况下测试由模型支持的功能。

“运行企业项目工作负载”

当应用计划在 Gemini Enterprise Agent Platform 中使用 Gemini API 时，使用企业模式、Google Cloud 项目和位置配置客户端。

“构建异步应用流程”

当模型请求需要融入异步 Python 应用时，使用 SDK 的异步客户端接口，并在使用后关闭异步客户端。

“统一请求构造方式”

在模型调用之间使用共享的 Pydantic 类型或字典，让 Python 代码库可以选择强调显式校验的对象或简洁的请求数据。

常见问题

Google Gen AI Python SDK 支持哪些 API？

代码仓库说明，它支持 Gemini Developer API 与 Gemini Enterprise Agent Platform API。

如何安装该 SDK？

使用 `pip install google-genai` 或 `uv pip install google-genai` 安装名为 `google-genai` 的软件包，然后通过 `from google import genai` 导入。

如何对客户端进行身份验证？

对于 Gemini Developer API，文档介绍的方法是将 API 密钥传入 `genai.Client()`，或通过 `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` 提供 API 密钥。对于企业平台，可在代码中或通过文档所述的环境变量配置企业模式、项目和位置。

该 SDK 能否用于异步 Python 代码？

可以。文档展示了通过客户端 `aio` 接口使用异步客户端，并建议在不再需要时显式关闭异步客户端。

升级前是否需要注意兼容性变化？

需要。代码仓库提示，即将发生自动函数调用变化，以及其他方法和字段被移除或重命名的情况。在查看迁移指南期间，建议将 SDK 固定在低于 3.0.0 的版本，以避免意外更新。

什么是 Google Gen AI Python SDK？