Gemini Notebook无法识别API密钥是因为未显式注入运行环境；需通过手动设置、%env命令或安全文件加载三种方式之一将密钥写入os.environ，且必须验证os.environ.get("GEMINI_API_KEY")非空。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Gemini Notebook无法识别你导入的API密钥，通常是因为密钥未被Notebook实际加载、格式污染、或根本未在Notebook运行环境中生效——它不读取系统环境变量，也不自动加载本地文件中的密钥字符串，必须显式注入到会话中。

确认密钥是否真正进入Notebook运行环境

在Notebook首个代码单元格中，直接运行以下检查命令：

import os; print(os.environ.get("GEMINI_API_KEY", "NOT SET"))

若输出“NOT SET”或空字符串，说明密钥尚未注入；此时无论你在终端里export过多少次、或config.json里写得多规范，Notebook都看不见。

方法一：在Notebook内手动设置环境变量（适合调试）

执行以下三行代码（注意替换为你的真实密钥）：

import os
os.environ["GEMINI_API_KEY"] = "AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
print("✅ 密钥已设入当前会话")

这一步只对当前Notebook会话有效，重启内核后需重设。不要把密钥硬编码提交到Git——【密钥一旦提交即视为泄露，必须立即在Google Cloud控制台撤销】。

Ask Gemini/ChatGPT

用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。

下载

方法二：通过%env魔法命令注入（Jupyter专属）

在任意单元格开头输入：

%env GEMINI_API_KEY=AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

该命令会将密钥写入当前内核的环境变量空间，后续调用google.generativeai.configure()时可直接读取。注意等号两侧不能有空格，且密钥必须是纯ASCII字符，中文引号、全角空格会导致解析失败。

方法三：从外部安全文件加载（生产推荐）

第一步：在Notebook同级目录创建.gemini_key文件（Linux/macOS）或gemini_key.txt（Windows），仅含一行密钥，无空行、无引号、无BOM头；

第二步：在Notebook中运行：

with open(".gemini_key", "r") as f:
  key = f.read().strip()
import os
os.environ["GEMINI_API_KEY"] = key

第三步：验证是否加载成功：assert os.environ.get("GEMINI_API_KEY"), "密钥为空，请检查文件路径与内容"。这一步必须执行，否则后续所有调用都会静默失败。