要在Python中调用Gemini模型，无论是进行文本生成、多轮对话还是图像理解任务，首要步骤都是完成SDK安装与API密钥配置。若这两项基础操作未到位，调用时会直接返回API key not valid或PermissionDenied错误，导致程序无法运行。下面将完整拆解接入流程，并重点说明几个容易被忽略的常见问题。
安装 google-generativeai SDK 并验证版本
打开终端环境（Windows用户使用CMD或PowerShell，macOS/Linux用户使用Terminal），直接执行以下命令：
pip install google-generativeai
安装过程本身并不复杂，但有一个关键细节极易被忽视——务必确认安装的是官方标准包，包名必须为google-generativeai。若少写连字符或误拼为google-genai、genai等名称，后续导入时会直接报错。安装完成后，启动Python解释器，运行以下三行代码做验证：
import google.generativeai as genaiprint(genai.__version__) # 正常输出应为0.8.0或更高版本genai.list_models()
若第三行出现PermissionDenied提示，说明SDK已经正确安装，但API密钥尚未配置；若第二行报AttributeError或ModuleNotFoundError，则表明安装存在问题或当前Python环境不匹配，需要重新检查环境配置。
获取并配置 GOOGLE_API_KEY
以下两种常用方式可根据实际使用场景灵活选择。
方法一：通过 Google Cloud Console 获取密钥（推荐）
① 打开 Google Cloud Console，新建一个项目或选择已有项目；
② 进入「API和服务 → 启用API和服务」，搜索并开启 generative-language.googleapis.com（2024年起该API已迁移至aiplatform.googleapis.com，旧路径仍保持兼容，无需额外处理）；
③ 进入「凭据 → 创建凭据 → API密钥」，复制生成的密钥字符串；
④ 在终端中临时设置环境变量（仅当前会话生效）：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()会静默执行成功但实际并未加载任何内容，导致后续获取到空密钥。许多初学者正是在这里遇到问题，代码逻辑看起来完全正确，却始终无法正常通过。
初始化模型并发送首条请求
API密钥配置完成后，在Python脚本中按以下三个步骤依次操作：
第一步：配置全局API密钥genai.configure(api_key=os.getenv("GOOGLE_API_KEY"))
第二步：选择模型并创建实例model = genai.GenerativeModel("gemini-1.5-flash")
第三步：发送纯文本提示词并输出响应内容response = model.generate_content("你好，请用中文简单介绍你自己")print(response.text)
如果response.text成功返回中文回复，恭喜接入工作已顺利完成。若出现ResourceExhausted错误，说明免费调用额度已用尽，需绑定信用卡激活5美元额度；若返回空字符串但未报错，极有可能是内容触发了安全过滤机制，更换一个更中性的提示词重新尝试即可解决。