Python-GenAI 安装与配置指南

1. 项目基础介绍

python-genai 是一个由 Google 开发的开源项目，该项目提供了一个 Python SDK，使得开发者能够方便地将 Google 的生成式模型集成到他们的 Python 应用中。该项目主要用于自然语言处理任务，如生成文本、摘要等。

主要编程语言：Python

2. 项目使用的关键技术和框架

• Google Generative AI Models：该项目集成了 Google 的生成式 AI 模型，如 Gemini Developer API 和 Vertex AI API。
• Pydantic：用于数据验证和设置类型提示。
• requests：用于发起 HTTP 请求。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装之前，请确保您的系统中已安装以下依赖：

• Python 3.6 或更高版本
• pip（Python 包管理器）

安装步骤

步骤 1：安装 Python

如果您尚未安装 Python，请访问 Python 官网下载并安装最新版本的 Python。安装完成后，确保 Python 和 pip 都已添加到系统环境变量中。

步骤 2：安装 python-genai 包

打开命令行工具（如终端或命令提示符），然后执行以下命令来安装 python-genai：

pip install google-genai

步骤 3：配置 API 密钥

要使用 python-genai，您需要一个有效的 API 密钥。如果您还没有 API 密钥，请按照以下步骤操作：

1. 访问 Google Cloud Console 并创建一个新的项目。
2. 在项目中启用所需 API。
3. 创建一个 API 密钥并记下它。

步骤 4：设置环境变量

根据您使用的是 Gemini Developer API 还是 Vertex AI API，您需要设置不同的环境变量。

对于 Gemini Developer API：

export GOOGLE_API_KEY='您的API密钥'

对于 Vertex AI API：

export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT='您的项目ID'
export GOOGLE_CLOUD_LOCATION='您的服务区域'

步骤 5：验证安装

要验证安装是否成功，您可以尝试运行以下 Python 代码：

from google import genai

client = genai.Client(api_key='您的API密钥')
response = client.models.generate_content(model='gemini-2.0-flash-001', contents='Hello, world!')
print(response.text)

如果一切正常，您应该会看到一段生成的文本输出。

以上步骤将帮助您成功安装和配置 python-genai 项目，接下来您就可以开始使用它来集成 Google 的生成式 AI 模型到您的应用中了。