Gemini 4 Neon 入门:调通 Interactions API 与思考档

用官方文档调通 Gemini 4 Neon

入门3 课时65 分钟图文实操

免费学习无需登录

Gemini 4 Neon 入门:调通 Interactions API 与思考档 课程封面

你将学会

  • 在 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 分钟
  1. 01开通付费层 API Key,用 SDK 和 curl 调通 gemini-4-neon认清调用 ID gemini-4-neon,开通付费层 API Key,并用 SDK 与 curl 发出第一个请求图文22 分钟开始本课
  2. 02按官方建议选型号,设置思考档并阅读 usage在 Neon、Carbon 和 Hydrogen 之间选型,设置思考档并对照官方 usage图文22 分钟开始本课
  3. 03传入官方示例 PDF,做多轮会话并认识隐式缓存把官方示例 PDF 交给模型做摘要,继续多轮会话,并认识隐式缓存图文21 分钟开始本课

课程说明

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,以及 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、按官方计费页开通付费层

官方来源