# Google Gen AI Python SDK 用于将 Google 生成式模型集成到 Python 应用的 SDK，支持 Gemini Developer API 与 Gemini Enterprise Agent Platform API。 - Findings24: - 网站: - 价格: Freemium - 分类: AI 软件开发工具包, 大语言模型 API ## 什么是 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 的版本，以避免意外更新。 ## 快速信息 - **产品类型**: Python SDK / 开发者库 - **软件包名称**: google-genai - **导入路径**: google.genai - **支持的服务**: Gemini Developer API 和 Gemini Enterprise Agent Platform API - **许可证**: Apache-2.0 - **主要用户**: 将 Google 生成式模型集成到应用中的 Python 开发者