Gemini 4 Neon API 定价、思考等级及 Cursor 和 Copilot 使用指南
介绍如何通过 Gemini API、Cursor 和 GitHub Copilot 使用 Gemini 4 Neon。对比官方 Token 价格、缓存输入费用、思考等级和 CursorBench 4.1 测试结果,并说明从 Hydrogen、Carbon、Gemini 3.1 Pro Preview 和 Gemini 3.8 Flash 迁移时需要调整的配置。
本文内容

如果你想用 Gemini 4 Neon 编写代码,首先需要指定模型 ID gemini-4-neon。Google 于 2026 年 11 月 18 日正式发布该模型,并向 Gemini API 付费项目开放。Cursor 和 GitHub Copilot 也已支持选择 Neon,但两款工具各自采用不同的访问条件和计费规则。
Gemini API 标准请求的价格为每百万输入 Token $3、每百万输出 Token $15。符合条件的隐式缓存命中,按比标准输入价低 95% 的费率计费,即每百万 Token $0.15。Neon 默认使用 high 思考等级,而 Carbon 默认使用 medium。
本文介绍 Neon 的接入方法、思考等级选择、费用估算,以及现有 Gemini 集成的迁移步骤。
1. Gemini 4 Neon 可以在哪里使用?
Neon 的官方模型 ID 是 gemini-4-neon。Google 于 2026 年 11 月 18 日宣布该模型正式可用。
Neon 定位于 Gemini 4 Hydrogen 和 Gemini 4 Carbon 之间,主要面向复杂软件工程、多文件调试、代码仓库级重构、知识工作和科学推理任务。
具体可用性取决于产品和订阅条件。
| 产品 | 可用状态 | 使用条件 |
|---|---|---|
| Gemini API | 正式可用 | Gemini API 付费档 |
| Google AI Studio | 可用 | Gemini API 付费访问权限;Google AI Pro 和 Ultra 订阅用户也可以试用 Neon |
| Android Studio | 通过 Gemini API 提供 | Gemini API 付费档 |
| Google Antigravity | 正在逐步开放 | Google AI Pro 或 Ultra 订阅 |
| Gemini app | 正在逐步开放 | Google AI Pro 或 Ultra 订阅 |
| Gemini for business | 可通过 API 和模型选择器使用 | 符合条件的企业访问权限 |
| GitHub Copilot | 已正式发布,正在逐步开放 | Pro+、Max、Business、Enterprise |
| Cursor | 已可使用 | 符合条件的套餐及第三方模型计费 |
Google 还宣布,将在发布后的几天内开始向符合条件的 Fairwind Program 成员开放访问权限。这是一条面向网络安全领域、需要单独满足资格条件的访问渠道。
需要区分 Gemini API 和 Google Cloud 的 Gemini Enterprise Agent Platform。后者的文档规定,Neon 仅向特定地区经过验证的企业客户开放。不要将这项限制理解为公开 Gemini Developer API 在全球范围内都受到同样的区域限制。
详细信息可参考 Google 官方发布公告和 Gemini API 更新日志。
在 GitHub Copilot 中使用
GitHub 于 11 月 18 日宣布 Neon 在 Copilot 中正式可用。
你可以在以下产品的模型选择器中找到它:
- Visual Studio Code 和 Visual Studio
- Copilot CLI
- GitHub Copilot coding agent
- GitHub Copilot app 和 github.com
- GitHub Mobile
- JetBrains IDE
- Xcode 和 Eclipse
支持的套餐包括 Copilot Pro+、Max、Business 和 Enterprise。
Neon 按使用量计费,价格采用模型提供商的公开定价。选择 Neon 并不意味着只会消耗订阅套餐内的常规使用额度。
Business 和 Enterprise 管理员可以通过 Copilot 设置中的模型策略控制访问权限。如果模型没有出现在选择器中,先检查开放进度和组织的模型策略,不必立即更换账号。
详细信息请查看 GitHub Copilot 官方公告。
在 Cursor 中选择模型及了解计费
Cursor 已列出准确的模型 ID gemini-4-neon。
打开 Chat 或 Agent 面板中的模型选择器,然后选择 Gemini 4 Neon。你也可以按 Cmd Ctrl + /,在可用模型之间切换。选定的模型会在不同对话之间保持不变,直到你主动更改。
Cursor 当前文档列出的第三方模型支持套餐包括 Premium 及以上套餐、Teams、Enterprise,以及旧版 Pro、Pro+ 和 Ultra。Free 和 Plus 仅包含 Cursor 自有模型。
选择 Neon 后,检查聊天面板顶部的模型选择器。这里会显示当前使用的模型。如果你选择 Auto,路由器可能会为不同请求选择其他模型。
Neon 属于第三方模型,不包含在 Cursor 套餐自带的常规使用额度中。
Cursor 文档说明了两种计费方式:
- The X Subscription: Neon 的使用费用从预付余额中扣除。
- 旧版 Cursor 套餐: Neon 的使用量计入 Other Models 使用额度。
官方公布的每百万 Token 价格如下:
| Token 类型 | 价格 |
|---|---|
| 输入 | $3.00 |
| Cache write(缓存写入) | 未列出 |
| Cache read(缓存读取) | $0.15 |
| 输出 | $15.00 |
使用 Neon 前,请确认当前 Cursor 套餐。第三方模型访问权限和套餐包含的使用额度是两项不同的权益。
Cursor 还列出了 Neon 的 200K 上下文窗口和 1M 最大上下文。这些数字是 Cursor 文档中的模型限制,不要与 Google API 统一的 1,048,576 Token 上下文窗口混淆。
详细信息请查看 Cursor 的 Gemini 4 Neon 文档和模型选择说明。
2. Gemini 4 Neon 的价格是多少?
截至 2026 年 11 月 19 日,Google Gemini API 标准请求的计费价格如下:
| 计费项目 | 每 1M Token 价格 |
|---|---|
| 输入 | $3.00 |
| 输出(包括思考 Token) | $15.00 |
| 隐式缓存输入 | $0.15 |
| 显式上下文缓存 | 不支持 |
Neon 没有免费档,必须使用 Gemini API 付费档。
Google 会对模型处理的所有 Token 计费,包括思考 Token。使用 Grounding 时,工具内部的系统指令和函数声明也计入费用。
标准输入价格为每百万 Token $3.00。符合条件的隐式缓存命中,按比标准输入价低 95% 的费率计费,因此缓存输入价格为每百万 Token $0.15。这项优惠只适用于隐式缓存命中,不适用于手动创建的显式缓存。
Neon 与 Carbon、Hydrogen 的价格对比
三个模型面向不同的工作负载。
| 模型 | 输入 / 1M | 输出 / 1M | 默认思考等级 |
|---|---|---|---|
| Gemini 4 Hydrogen | $1.50 | $7.50 | high |
| Gemini 4 Neon | $3.00 | $15.00 | high |
| Gemini 4 Carbon | 适用至 2026 年 11 月 30 日(含当天):$2.00;2026 年 12 月 1 日起:$4.00 | 适用至 2026 年 11 月 30 日(含当天):$10.00;2026 年 12 月 1 日起:$20.00 | medium |
以上均为 Gemini API 付费档的标准请求价格。
Carbon 的介绍价适用至 2026 年 11 月 30 日,包含当天。2026 年 12 月 1 日起,标准价格生效。Neon 没有介绍价。
日常编程任务仍然适合使用价格更低的 Hydrogen。Neon 的价格更高,但在复杂、高频的工程任务中提供更深入的推理能力。对于最困难的架构设计、科学研究、调试和安全问题,Carbon 仍然是合适的选择。
如果需要了解 Carbon 的完整费用和迁移细节,可以阅读 Gemini 4 Carbon API 定价与迁移指南。
示例:估算一次代码请求的费用
以下估算仅适用于标准同步 API 请求。假设一次请求使用以下 Token:
- 未缓存的输入 Token:100,000
- 输出 Token:20,000(包括思考 Token)
- 没有额外的 Grounding 费用
按照标准 API 价格计算:
| 项目 | 计算方式 | 费用 |
|---|---|---|
| 输入 | 0.1 × $3 | $0.30 |
| 输出 | 0.02 × $15 | $0.30 |
| 合计 | $0.30 + $0.30 | $0.60 |
如果其中 80,000 个输入 Token 符合缓存条件,费用会变成:
- 未缓存的 20,000 个 Token:$0.06
- 已缓存的 80,000 个 Token:$0.012
- 输出:$0.30
预计总费用为 $0.372。
这只是用于说明标准请求计费方式的估算,不代表每次请求都有固定价格。实际费用取决于提示词长度、推理深度、工具调用、缓存命中情况和生成内容的长度。Batch、Flex 等其他执行模式不包含在这组估算中。
应该选择哪个模型?
日常编程、交互式应用和对成本敏感的 Agent 执行任务,优先使用 Hydrogen。
如果 Hydrogen 难以处理多文件修改或复杂推理,可以选择 Neon。对于这类任务,建议先使用默认的 high。
如果困难任务需要额外验证,尤其涉及架构、安全或科学研究,则选择 Carbon。
Carbon 的介绍价适用至 2026 年 11 月 30 日(含当天),在此期间价格低于 Neon。2026 年 12 月 1 日起,Carbon 标准价格生效。届时应重新比较两者的成本。
3. 应该使用哪个思考等级?
Neon 支持四种思考等级:
lowmediumhighxhigh
默认值为 high。
思考等级控制推理深度、延迟和 Token 消耗。它既不是订阅套餐等级,也不是独立的模型 ID。
| 等级 | 典型用途 | 取舍 |
|---|---|---|
low | 高吞吐处理、快速聊天 | Token 消耗和延迟最低 |
medium | 交互式编程、UI 原型设计、需要快速响应的工具调用 | 响应更快,Token 消耗更少 |
high | 复杂编程、Agent、工具调用、多模态分析 | 推荐的默认选择 |
xhigh | 困难的多步骤工程任务、数学和科学分析 | 推理最深入,但延迟和 Token 消耗更高 |
复杂编程任务建议从 high 开始。
如果交互式 Agent 需要更快响应,可以使用 medium。对于重复执行、成本敏感的任务,可以尝试 low。
如果 high 无法解决困难任务,再切换到 xhigh。它尤其适合涉及多个文件的架构修改、复杂调试和科学推理。
不要对所有请求都使用 xhigh。额外的思考 Token 会增加费用,也可能延长响应时间。
Neon 与 Carbon 有什么区别?
Carbon 默认使用 medium,支持 low、medium 和 high。
Neon 默认使用 high,并额外支持 xhigh。
如果你只替换 Carbon 的模型 ID,而不修改应用程序的其他配置,这项差异就很重要。Neon 从更高的思考等级开始,因此迁移后,即使请求内容相同,也可能消耗更多思考 Token。
如果原来的 Carbon 集成明确使用了 medium,迁移初期应在 Neon 中显式设置 medium,以保持原有的思考等级。之后再单独测量 Neon 的实际延迟和 Token 消耗。
Google 建议使用自己的任务评估不同等级,并选择满足质量要求的最低等级。
详细说明请参考 Google 的思考等级文档。
4. 如何通过 API 接入 Gemini 4 Neon?
你可以使用 Google 官方 Gen AI SDK 和 Interactions API 发送第一个请求。
准备以下内容:
- 可以访问 Google AI Studio 的 Google 账号。
- Gemini API key。
- 已开通 Gemini API 付费访问权限的项目。
- Google Gen AI Python SDK。
在 Google AI Studio 创建 API key。Neon 不支持 Free 档,因此还需要为项目启用 Cloud Billing,开通 Gemini API 付费档。
在 Bash 中输入密钥,不要将其显示在终端中:
read -rs GEMINI_API_KEY && export GEMINI_API_KEY
安装 Python SDK:
pip install --upgrade google-genai
运行下面的最小请求:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-neon",
input="Build an interactive single-file HTML token bucket rate-limiter simulator with live sliders for burst size and request traffic."
)
print(interaction.output_text)
SDK 会从环境变量读取 API key。请求指定 gemini-4-neon,并通过 interaction.output_text 获取生成的文本。
如果请求成功返回,就说明 API key、项目、端点和模型 ID 已经正确配合工作。
对于更复杂的工程任务,可以显式提高思考等级:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-neon",
input="Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
generation_config={
"thinking_level": "xhigh"
}
)
print(interaction.output_text)
第一个请求用于确认连接正常。第二个请求展示了如何提高推理深度。
如果响应被截断怎么办?
Neon 的统一上下文窗口为 1,048,576 Token。输入、思考和输出 Token 共用这一额度。
默认同步输出上限为 65,536 Token。这个限制独立于总上下文限制。
max_output_tokens 字段限制一次响应中思考 Token 与生成内容的总量。如果现有应用设置了较低上限,迁移前应先检查。
对于普通任务,可以保留默认值或省略该字段。如果应用以前设置了 8,192 Token 的固定上限,Google 建议删除这个硬编码限制,或者将其提高到 65,536。
如果需要生成超过 65,536 Token 的内容,Google 文档建议使用后台执行方式,设置 background=True,并提高 max_output_tokens。最大值为 1,048,576 减去输入 Token 数量。
Google 的长文本生成文档建议,使用最新版本的 Google GenAI SDK 实现客户端续传。Neon 指南没有指定最低 SDK 版本,因此不要依赖未经确认的版本号,应检查当前 SDK 文档。
Interactions API 的 REST 示例使用 v1beta。按照官方 REST 示例接入时,请保留这个 API 版本。
详细步骤请参考 Google 的长文本生成说明。
5. CursorBench 4.1 的结果说明了什么?
Cursor 于 2026 年 11 月 18 日公布的 CursorBench 4.1 结果显示,Neon 在参测模型中处于领先位置。
| 模型与思考等级 | 得分 | 每项任务平均费用 |
|---|---|---|
| Neon Extra High | 65.4% | $10.67 |
| Neon High | 63.7% | $6.54 |
| Carbon High | 61.5% | $8.52 |
| Hydrogen Extra High | 61.4% | $8.09 |
| Fable 5.2 Max | 61.3% | $48.11 |
| Carbon Medium | 60.4% | $7.22 |
| Neon Medium | 57.7% | $3.07 |
| Hydrogen High | 57.3% | $4.57 |
这些数据反映的是 Cursor 的 Agent 评测结果,而不是独立的模型基准测试。
CursorBench 使用真实 Cursor 会话中的模糊、多文件任务评估 Agent。得分反映任务表现,每项任务的费用则根据实际消耗的 Token 数量和公开 Token 价格计算。
Cursor 在 11 月 18 日更新了基准测试,修改了指令遵循测试题目,并延长了 Agent 的时间限制。
因此,与旧版 CursorBench 结果比较时,需要考虑这些变化。
应该如何解读这些分数?
Neon High 得分为 63.7%,Hydrogen High 得分为 57.3%。
两者在这项基准测试中的差距为 6.4 个百分点。
Neon Extra High 达到 65.4%,但每项任务的平均费用为 $10.67。Neon High 得分为 63.7%,每项任务费用为 $6.54。
这说明更深入的推理提高了基准测试成绩,同时也增加了测得的任务成本。
在这次评测中,Neon High 的得分超过 Carbon High,每项任务的费用也更低。但这并不能证明 Neon 在所有代码仓库或架构任务中都优于 Carbon。
Cursor 明确提醒,测试结果存在波动,较小的分数差异可能不具有统计显著性。
可以用这些结果选择初始配置,然后在自己的代码仓库中运行实际任务。重点测量任务完成质量、不必要的修改、测试结果、延迟和实际使用量。
如果想进一步比较不同编码 Agent 的评测结果和推理等级,可以阅读 Coding Agent Index v2.1:Fable 5.2 与 Opus 5.5 的推理等级对比。
完整数据请查看 CursorBench 4.1 排行榜。
6. 如何从 Hydrogen、Carbon 或 Gemini 3 迁移?
Google 文档说明,Gemini 4 系列模型之间的迁移相对简单,主要修改模型 ID 即可。
但从 Gemini 3 迁移时,还需要清理部分请求配置。
从 Gemini 4 Hydrogen 或 Carbon 迁移
如果应用已经使用其他 Gemini 4 模型,可以先修改模型 ID:
model="gemini-4-neon"
基本的 Gemini 4 模型迁移不需要修改请求 Schema。
检查思考等级配置:
- Hydrogen 默认使用
high。 - Carbon 默认使用
medium。 - Neon 默认使用
high。
如果原来的 Carbon 应用依赖默认值,首次迁移测试时应显式设置 medium。
然后再与 high 的结果进行比较。
不要假设相同的提示词一定会产生相同的 Token 消耗或延迟。
如果需要详细了解 Hydrogen 的价格和迁移行为,可以参考 Gemini 4 Hydrogen API 定价与迁移指南。
从 Gemini 3.1 Pro Preview 或 Gemini 3.8 Flash 迁移
Google 建议将 gemini-3.1-pro-preview 升级到 gemini-4-neon。对于最困难的问题,可以选择 Carbon。
如果你正在从 gemini-3.8-flash 或更早的 Gemini 3 模型迁移,请检查以下变化。
1. 替换模型 ID。
model="gemini-4-neon"
2. 替换旧的思考配置。
Neon 接受以下值:
thinking_level="low"
thinking_level="medium"
thinking_level="high"
thinking_level="xhigh"
默认值变为 high。
旧的 minimal 值会被拒绝。删除 thinking_budget,改用 thinking_level。
3. 检查上下文和输出限制。
Gemini 3.8 Flash 将输入 1M 和输出 64K 的 Token 限制分开计算。Neon 则让输入、思考和输出共用一个 1,048,576 Token 的上下文窗口。
Neon 的同步请求输出上限为 65,536 Token。如果需要超过这一限制的输出,请使用第 4 节介绍的后台执行方式。同时检查代码中硬编码的 max_output_tokens 限制,并在必要时进行调整。
4. 删除显式上下文缓存。
Neon 不支持通过 cachedContents 或 caches.create 创建显式上下文缓存。
从请求中删除 cached_content 字段。
改用隐式缓存。Google 会自动对至少包含 4,096 个 Token 的共享提示词前缀应用缓存。符合条件的隐式缓存命中,按比标准输入价低 95% 的费率计费,即每百万 Token $0.15。
将静态指令、代码仓库上下文和可重复使用的文档放在提示词开头。这样,重复请求更有机会共享可缓存的前缀。
5. 删除采样参数。
删除以下参数:
temperature
top_p
top_k
如果这些字段的自定义值在有效范围内,Neon 会忽略它们。超出范围的值会返回 400 验证错误。
不要因为以前的 Gemini 3 集成使用过这些设置,就继续保留它们。
6. 保留对话状态和思考签名。
对于使用 Interactions API 的多轮会话,使用 previous_interaction_id 保留对话状态。
如果应用自行管理 generateContent 历史记录,请在后续每一轮请求中,原样返回之前的模型响应及其思考签名(thought signatures)。不要在并行的 functionCall 部分之间复制思考签名。
对于使用工具调用的应用,应通过原生 function calling 声明工具。不要在没有声明工具的情况下,要求模型通过普通文本生成自定义 JSON 格式的工具调用。Google 的迁移指南指出,这种情况可能导致 MALFORMED_FUNCTION_CALL 错误。
部署现有 Agent 之前,请检查这些变化。
完整说明请查看 Google Gemini 4 Neon 迁移检查清单。
7. 应该选择哪种访问方式?
选择取决于你是否需要 Google 原生 API、现有编码工具,或者独立的计费方式。
| 访问方式 | 所需条件 | 适用场景 |
|---|---|---|
| Google Gemini API | Google 账号、API key、已启用 Cloud Billing 的付费项目 | 你负责管理应用,并希望直接调用 API |
| Google AI Studio | Gemini API 付费访问权限,或符合条件的 Google AI Pro、Ultra 订阅 | 希望在集成之前比较不同提示词 |
| Cursor | 支持第三方模型的套餐,以及适用的预付余额或使用额度 | 已经在 Cursor 中开发 |
| GitHub Copilot | Pro+、Max、Business 或 Enterprise | 现有开发工作流已经使用 Copilot |
| 其他按量付费 API 网关 | 目录中列出的模型 ID,以及文档明确支持的端点兼容性 | 希望使用独立的模型访问和计费渠道 |
BetterToken 是面向个人、开发者和团队的多模型平台及 API 访问层,支持按量使用模型。更换 API 端点之前,请确认准确的模型 ID 和工具兼容性。不要假设网关已经提供所有新发布的模型。
如果你必须使用准确的 Neon 模型,并希望自行控制思考等级、缓存和 API 请求配置,Google Gemini API 付费档是最直接的选择。
如果不想自行管理 API 请求,可以先使用 Cursor 或 Copilot,再确认第三方模型适用的独立计费规则。
最终接入检查清单
将 Neon 用于生产环境中的编码 Agent 之前,请确认:
- 模型 ID 为
gemini-4-neon。 - Gemini API 项目已经开通付费档,并启用了 Cloud Billing。
- 应用程序可以读取 API key。
- 初始思考等级为
high,或者已经明确选择其他等级。 - 预算已按输出价格计算思考 Token 的费用。
- 应用程序不再依赖显式上下文缓存。
- 已删除不受支持或会被忽略的生成参数。
- 同步输出上限的计算包含思考 Token。
- 多轮工具调用能够正确保留所需的对话状态和思考签名。
- 已使用实际任务评估 Neon,确认任务完成质量和 Token 消耗符合生产环境要求。
如果 Hydrogen 难以处理复杂编程任务,而 Carbon 又提供了不必要的额外推理,Neon 就是一个合适的起点。先使用 high,通过自己的任务衡量实际效果。只有当额外推理确实能改善结果时,才切换到 xhigh。