成功安装并配置 google ai sdk 需四步：一、确认 python≥3.9 并创建激活虚拟环境；二、pip install google-genai 且版本≥0.8.4；三、通过 ai studio 获取 api 密钥并设为环境变量；四、用 genai.generativemodel 调用 gemini-1.5-flash 测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在 Python 项目中调用 Google 的生成式 AI 模型，但尚未完成开发环境的初始化，则可能是由于 SDK 缺失、版本不匹配或认证未就绪。以下是安装并配置最新 Google AI SDK 的具体步骤：
一、确认 Python 版本并创建隔离环境
Google AI SDK（即 google-genai）要求 Python 3.9 或更高版本，且强烈建议使用虚拟环境避免依赖冲突。隔离环境可确保 SDK 及其依赖独立于系统全局包，防止版本错乱。
1、在终端中执行 python --version，确认输出为 Python 3.9.0 或更高版本。
2、执行 python -m venv genai-env 创建名为 genai-env 的虚拟环境。
3、激活该环境：Linux/macOS 执行 source genai-env/bin/activate；Windows 执行 genai-env\Scripts\activate.bat。
二、安装 google-genai SDK 并验证基础功能
google-genai 是 Google 官方维护的 Python SDK，用于对接 Gemini Developer API。必须通过 pip 安装其最新稳定版，以确保兼容性与安全性。
1、在已激活的虚拟环境中运行：pip install google-genai。
2、安装完成后，启动 Python 解释器，输入 import google.generativeai as genai，若无报错则导入成功。
3、执行 pip show google-generativeai，确认 Version 字段值不低于 0.8.4（截至 2026 年 3 月的最新稳定版）。
三、获取并安全注入 API 密钥
所有 Gemini Developer API 请求均需携带有效 API 密钥，该密钥必须通过 Google AI Studio 生成，并通过环境变量注入，严禁硬编码。
1、访问 https://aistudio.google.com/，使用 Google 账户登录后进入 API 密钥管理页，点击“创建 API 密钥”。
2、将生成的密钥复制并保存至本地安全位置；随后在终端中设置环境变量：Linux/macOS 执行 export GOOGLE_API_KEY="your_api_key_here"；Windows 执行 set GOOGLE_API_KEY=your_api_key_here。
3、在 Python 脚本开头添加 import os 和 genai.configure(api_key=os.getenv("GOOGLE_API_KEY"))，确保密钥被正确读取。
四、初始化模型客户端并测试基础调用
完成 SDK 安装与密钥配置后，需实例化模型客户端并发起一次最小可行请求，以验证端到端链路是否通畅。
1、在 Python 脚本中执行 client = genai.GenerativeModel("gemini-1.5-flash")，创建轻量级模型实例。
2、构造最简 Prompt：response = client.generate_content("你好，请用一句话介绍自己。")。
3、打印 response.text，若返回非空字符串且无 PermissionDenied 或 InvalidAPIKey 错误，则表明 SDK 已成功安装并配置完毕。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
