必须先配置 Gemini 内核、注入 API Key、执行最小 REST 请求三步：选 gemini-python 内核并验证路径含 gemini-notebook；通过 Secrets 或环境变量注入密钥；用 requests 直调 /v1beta/models/gemini-3.5-flash:generateContent 接口成功返回文本即通。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用 Gemini Notebook 直接跑通第一个 API 调用，但连环境都没配好、不知道密钥放哪、代码一粘就报错——这不是你代码写得不对，而是缺了三样东西：一个能识别 Gemini 的内核、一个合法的 API Key、一段不依赖外部 SDK 的最小可执行请求体。
确认 Gemini Notebook 已启用 Gemini 内核
打开 Gemini Notebook（网页版或本地 JupyterLab），点击右上角「Kernel」→「Change kernel」→ 选择 【gemini-python】。如果列表里没有这个选项，说明内核未安装，此时不要手动 pip install google-generativeai——Gemini Notebook 自带专用内核，需通过其内置命令激活：%pip install -U gemini-notebook-kernel，执行后重启内核。
重启后运行 import sys; print(sys.executable)，输出路径中必须含 gemini-notebook 字样，否则后续所有 API 调用都会因认证模块缺失而失败。
获取并注入 API Key（仅限 Notebook 环境）
方法一：直接在 Notebook 单元格中设置环境变量（临时生效，刷新即失效）
执行：import os; os.environ["GEMINI_API_KEY"] = "your_actual_39_character_key_here"
方法二：通过 Notebook 内置密钥管理器（推荐，持久化且不暴露在代码中）
点击菜单栏「Settings」→「Secrets」→「Add a secret」→ Name 填 GEMINI_API_KEY，Value 粘贴你的密钥 → 点击 Save。
【密钥一旦保存无法查看，关闭页面即丢失，请务必提前复制备份】
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
验证是否注入成功：运行 os.getenv("GEMINI_API_KEY")，返回非 None 字符串即为有效。
执行最简 API 请求（绕过 SDK，直调 REST 接口）
第一步：导入必要模块import requests, json
第二步：构造请求体与 URLurl = "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent?key=" + os.getenv("GEMINI_API_KEY")payload = {"contents": [{"parts": [{"text": "Hello world"}]}]}
第三步：发送 POST 请求并解析响应resp = requests.post(url, json=payload, timeout=30)assert resp.status_code == 200, f"API error: {resp.status_code} {resp.text}"print(json.loads(resp.text)["candidates"][0]["content"]["parts"][0]["text"])
这一步必须看到“Hello world”或类似响应文本才代表链路通了。如果报 KeyError: 'candidates'，说明密钥无效或模型名拼错；如果报 ConnectionError，检查 Notebook 是否启用了代理配置（Gemini Notebook 默认走直连，国内用户需在 Settings → Network 中开启内置代理开关）。
