Gemini API接入Python项目：SDK安装与环境配置详解

要在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 genai
print(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_dotenv
load_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美元额度；若返回空字符串但未报错，极有可能是内容触发了安全过滤机制，更换一个更中性的提示词重新尝试即可解决。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Gemini API接入Python项目：SDK安装与环境配置详解要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题