必须先安装google-generativeai SDK并安全配置GOOGLE_API_KEY，否则调用会报API key not valid或PermissionDenied；安装后需验证版本≥0.8.0且能列出模型；密钥可通过Google Cloud Console获取或用.env文件管理；最后configure、选择模型、generate_content三步完成首条请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Python项目中调用Gemini模型的文本生成、多轮对话或图像理解能力，必须先完成SDK安装与API密钥的安全配置，否则调用会直接报错google.generativeai.exceptions.ClientError: API key not valid或PermissionDenied。
安装 google-generativeai SDK 并验证版本
打开终端（Windows用户用CMD/PowerShell，macOS/Linux用Terminal），执行安装命令：
pip install google-generativeai
这一步操作起来很简单，但必须确认安装的是官方包而非拼写近似的第三方包（如google-genai或genai）。错误包名会导致后续所有导入失败。
立即学习“Python免费学习笔记（深入）”；
安装完成后，启动Python解释器，运行以下三行代码验证是否成功：
import google.generativeai as genaiprint(genai.__version__) # 输出应为 0.8.0 或更高genai.list_models()
如果第三行抛出PermissionDenied，说明SDK已装好但尚未配置API密钥；若第二行报AttributeError或ModuleNotFoundError，则说明安装失败或环境不匹配。
获取并配置 GOOGLE_API_KEY
方法一：通过 Google Cloud Console 获取密钥（推荐）
① 访问 Google Cloud Console，选择或新建项目；
② 进入「API和服务 → 启用API和服务」，搜索并启用 generative-language.googleapis.com（注意：2024年起该API已迁移至 aiplatform.googleapis.com，但旧路径仍兼容）；
③ 进入「凭据 → 创建凭据 → API密钥」，复制生成的密钥字符串；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
④ 在终端中临时设置环境变量（仅当前会话有效）：export GOOGLE_API_KEY="AIzaSy..."（Linux/macOS）set GOOGLE_API_KEY=AIzaSy...（Windows CMD）
方法二：使用 .env 文件管理（生产环境首选）
在项目根目录创建 .env 文件，写入一行：GOOGLE_API_KEY=AIzaSy...
然后在Python脚本开头添加两行加载逻辑：
from dotenv import load_dotenvload_dotenv()
注意：必须提前安装 python-dotenv（pip install python-dotenv），否则 load_dotenv() 会静默失败且不报错。
初始化模型并发送首条请求
在Python脚本中，按顺序执行以下三步：
第一步：调用 configure 配置全局API密钥genai.configure(api_key=os.getenv("GOOGLE_API_KEY"))
第二步：选择模型并初始化实例model = genai.GenerativeModel("gemini-1.5-flash")
第三步：发送纯文本Prompt并打印响应内容response = model.generate_content("你好，请用中文简单介绍你自己")print(response.text)
如果 response.text 返回正常中文回复，说明接入已完成。若提示 ResourceExhausted，说明免费配额已用尽或未绑定信用卡激活$5额度；若返回空字符串但无报错，可能是模型返回了安全拦截内容，需更换Prompt重试。
