
你将学会
- 在 Google AI Studio 创建 API Key,开通付费层,并导出 `GEMINI_API_KEY`
- 用官方 Python SDK 和 curl,向 Interactions API 发出第一个 `gemini-4-neon` 请求
- 看懂 `steps` 数组、`output_text`,以及 400 `API_KEY_INVALID`
- 按官方建议在 Neon、Carbon 和 Hydrogen 之间做选择,并设置 `thinking_level`
- 对照官方 usage 示例阅读 `total_thought_tokens`,给输出留出足够空间
- 按官方文档把一份公开 PDF 交给模型做摘要,并用 `previous_interaction_id` 做多轮会话
- 认识 Neon 只支持隐式缓存,以及缓存命中后的刊例价
适合谁
- 要立刻调用新发布的 `gemini-4-neon` 的开发者
- 已有 `generateContent` 集成,准备迁到 Interactions API 的人
- 需要先按官方刊例价估算成本,再决定用 Neon、Carbon 还是 Hydrogen 的团队
课前准备
- 会用 Linux、macOS 或 Windows 终端
- 本机有 Python 3.9 或更高版本,以及 curl
- 已有 Google 账号,并能在 Google AI Studio 创建 API Key、按官方计费页开通付费层
课程目录
3 课时 · 65 分钟课程说明
Gemini 4 Neon 是 Google DeepMind 在 2026 年 11 月 18 日发布的 Gemini 4 系列模型。调用 ID 是 gemini-4-neon。官方把它放在偏重长程推理的 Gemini 4 Carbon 与日常快速执行的 Gemini 4 Hydrogen 之间,面向复杂软件工程、知识工作和科学流程。它接收文本、图片、音频、视频和 PDF,输出文本;输入、思考和输出共用 1,048,576 tokens 的统一上下文窗口。默认同步最多输出 65,536 tokens,开启 long decode 后可以一直生成到 100 万 tokens 减去输入。思考档有 low、medium、high(默认)和 xhigh 四档。它只在 Gemini API 付费层提供,免费层不可用。刊例价按完整 1M 窗口均一计价:输入每 100 万 tokens $3.00,输出(含思考 tokens)$15.00,隐式缓存命中后的缓存输入为 $0.15。
本课按 Google AI Studio 官方文档整理,对照页包括「What's new in Gemini 4 Neon」、Neon 模型页、「Getting started」、Interactions API 概览、「Choosing a model」、「Gemini thinking」、定价、上下文缓存、文档理解和 long decode,以及 2026 年 11 月 18 日的官方发布说明。全部链接见课程介绍末尾。成功调用的对照结果一律引用官方文档里的示例,不编造运行输出。
测试说明:2026-11-20 在 Debian 云主机上核对了官方文档正文、发布页头图和命令能否原样复制;用假 API Key 实打了 HTTP 400,reason 为 API_KEY_INVALID。本机没有可用的 Gemini API Key,因此成功回复、思考 usage 和文档摘要都采用官方示例。你用自己的付费额度跑通后,具体文字和 Token 数会不同,字段结构应与官方一致。没有实测的部分会在正文写明,包括:AI Studio 开通与账单因账号而异、long decode 后台任务的完整跑通、隐式缓存命中的真实 total_cached_tokens,以及标准交互限速的实时配额。
你会学到
- 在 Google AI Studio 创建 API Key,开通付费层,并导出
GEMINI_API_KEY - 用官方 Python SDK 和 curl,向 Interactions API 发出第一个
gemini-4-neon请求 - 看懂
steps数组、output_text,以及 400API_KEY_INVALID - 按官方建议在 Neon、Carbon 和 Hydrogen 之间做选择,并设置
thinking_level - 对照官方 usage 示例阅读
total_thought_tokens,给输出留出足够空间 - 按官方文档把一份公开 PDF 交给模型做摘要,并用
previous_interaction_id做多轮会话 - 认识 Neon 只支持隐式缓存,以及缓存命中后的刊例价
适合
- 要立刻调用新发布的
gemini-4-neon的开发者 - 已有
generateContent集成,准备迁到 Interactions API 的人 - 需要先按官方刊例价估算成本,再决定用 Neon、Carbon 还是 Hydrogen 的团队
先修
- 会用 Linux、macOS 或 Windows 终端
- 本机有 Python 3.9 或更高版本,以及 curl
- 已有 Google 账号,并能在 Google AI Studio 创建 API Key、按官方计费页开通付费层
官方来源
- 发布说明:https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/
- What's new in Gemini 4 Neon:https://aistudio.google.com/docs/whats-new-gemini-4-neon
- Gemini 4 Neon 模型页:https://aistudio.google.com/docs/models/gemini-4-neon
- Getting started:https://aistudio.google.com/docs/get-started
- Interactions API 概览:https://aistudio.google.com/docs/interactions-overview
- Choosing a model:https://aistudio.google.com/docs/choosing-a-model
- Gemini thinking:https://aistudio.google.com/docs/thinking
- 定价:https://aistudio.google.com/docs/pricing
- 使用 API Key:https://aistudio.google.com/docs/api-key
- 上下文缓存:https://aistudio.google.com/docs/caching
- 文档理解:https://aistudio.google.com/docs/document-processing
- Long decode:https://aistudio.google.com/docs/long-decode
- 发布说明(changelog,2026-11-18):https://aistudio.google.com/docs/changelog