作者注:Gemini 4 Neon 有四档思考等级,默认是 HIGH,思考 token 按输出计价。本文说明每一档适合什么任务,也会讲清楚为什么不能把 Carbon 的档位配置直接套到 Neon 上。
接入 Gemini 4 Neon 之后,很多开发者遇到的第一个问题不是效果,而是账单。思考 token 按输出价格计费,档位开得越高,模型在给出答案前想得越多,输出 token 也越多。本文给出的建议是 按任务选档,够用就停,帮你在效果和成本之间找到合适的档位。
这不是一篇“越高越好”的参数科普。 Google Cloud 文档已经把 Neon 每一档的适用场景写得很具体,本文以官方文档为依据,整理成可以直接照着配置的对照表,并补充几个常见的报错和混淆点。
核心价值:读完本文,你会知道 Gemini 4 Neon 默认就是 HIGH,分类和路由类任务用 LOW 就够了,XHIGH 只留给最重的工作,同时不会把 Carbon 或 Antigravity 里的设置误用到 API 调用里。

Gemini 4 Neon 思考等级核心要点
先看最关键的几条结论。这些都来自 Google Cloud 的 Gemini 4 Neon 文档(2026-11-19 版本)和 AI Studio 的最新模型页:
| 要点 | 说明 | 对你的价值 |
|---|---|---|
| 四档思考等级 | LOW、MEDIUM、HIGH、XHIGH,默认 HIGH | 不传参数时已经是偏高档位,需要主动降档 |
| 旧参数会报错 | thinking_budget 和 MINIMAL 会返回 HTTP 400 |
迁移旧代码时必须改参数 |
| 思考 token 计费 | 思考 token 按输出单价计价 | 档位直接影响输出侧成本 |
| 档位不跨模型通用 | Carbon 只有三档,默认 medium;Hydrogen 与 Neon 一样有四档 | 不能把一个模型的配置复制到另一个 |
| 界面与 API 不同 | Antigravity 界面里的 Extra 就是 xhigh,上下文上限也不同 | 避免拿 IDE 体验去推断 API 行为 |
Gemini 4 Neon 四档思考等级与任务对应
官方文档给每一档都写明了推荐场景。整理成下表,方便配置时对照:
| 思考等级 | 官方推荐场景 | 典型业务举例 | 选择提示 |
|---|---|---|---|
LOW |
高吞吐的分类、路由、摘要 | 工单打标签、意图识别、长文要点提炼 | 批量任务优先选这一档 |
MEDIUM |
一般编码、文档问答 | 写函数、改 bug、基于知识库回答问题 | 大多数日常开发请求够用 |
HIGH(默认) |
多步工具调用、复杂多模态 | Agent 连续调用工具、图文混合分析 | 不传参数时就是这一档 |
XHIGH |
证明、科学分析、最重的多文件工程 | 数学推导、实验数据分析、跨多个模块的重构 | 只给最重的任务用 |
这张表要注意两点。第一,默认值是 HIGH,不是 MEDIUM。也就是说,如果你在代码里什么都不写,每一次分类请求都会按“多步工具调用”的强度去思考,这对高吞吐场景来说通常是浪费。第二,XHIGH 是 Neon 的上限档,它的用途是证明和最重的工程任务,日常编码请求开到 XHIGH,多半只会换来更长的等待和更多的输出 token。
为什么 Gemini 4 Neon 要“够用就停”
成本的关键在于计价方式。思考 token 按输出单价计费,而 Gemini 4 Neon 的输出单价是输入单价的 5 倍(Google 公告标价为输入 $3、缓存 $0.15、输出 $15,单位都是每百万 token)。思考越多,最贵的那部分 token 就越多。
具体每一档会多消耗多少思考 token,取决于任务本身的复杂度,官方没有给出固定比例,本文也不提供“降一档能省多少钱”这种数字。比较稳妥的做法是在自己的业务样本上分别跑 LOW 和默认 HIGH,对比返回结果中的输出 token 用量和答案质量,再决定是否降档。

Gemini 4 Neon 思考等级快速上手
极简示例:用 LOW 档做分类
API易 提供 OpenAI 兼容接口,用官方 openai Python SDK 改一下 base_url 就能调用 Gemini 4 Neon。下面按步骤写出关键代码,每一步都可以直接复制:
- 安装 SDK:
pip install openai - 创建客户端:
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - 指定模型:
model="gemini-4-neon" - 设置思考等级:
reasoning_effort="low" - 发送请求:
client.chat.completions.create(model="gemini-4-neon", reasoning_effort="low", messages=[{"role": "user", "content": "判断这条工单属于:账单 / 技术 / 其他。工单内容:……"}]) - 读取结果:
resp.choices[0].message.content
分类任务只需要一个标签,LOW 档已经能满足要求。如果改成写代码或者基于文档回答问题,把第 4 步换成 reasoning_effort="medium" 即可。
需要说明的是,参数名称取决于你使用的接口格式。在 Gemini 原生接口里,思考等级写在 thinking_config 的 thinking_level 字段里,取值为 LOW / MEDIUM / HIGH / XHIGH。在 OpenAI 兼容格式下,思考强度一般通过 reasoning_effort 传入。具体字段映射以平台文档为准,上线前建议先用一条请求确认档位确实生效。
查看完整实现思路:按任务类型自动选档
在生产环境里,更好的做法是让业务代码根据任务类型选择档位,而不是全局写死一个值。实现可以分成下面几步:
1. 定义映射表:`LEVEL_MAP = {“classify”: “low”, “route”: “low”, “summary”: “low”, “code”: “medium”, “doc_qa”: “medium”, “agent”: “high”, “multimodal”: “high”, “proof”: “xhigh”, “multi_file”: “xhigh”}`
2. 设置兜底值:`level = LEVEL_MAP.get(task_type, “high”)`,未知任务沿用官方默认 HIGH,这样不会意外降低质量
3. 统一客户端:`client = OpenAI(api_key=os.getenv(“APIYI_KEY”), base_url=”https://api.apiyi.com/v1″)`
4. 发起调用:`client.chat.completions.create(model=”gemini-4-neon”, reasoning_effort=level, messages=messages)`
5. 记录用量:把 `resp.usage` 里的输出 token 数和 `task_type`、`level` 一起写入日志,方便按任务类型统计思考开销
6. 处理 400 错误:捕获异常后检查请求里是否还带着 `thinking_budget` 或 `MINIMAL`,这两个值在 Neon 上都会返回 HTTP 400
第 2 步的兜底值很重要。如果映射表漏掉了某种任务,宁可按默认 HIGH 多花一些 token,也比静默降到 LOW 导致答案出错要好。等日志积累一段时间后,再根据数据逐类下调档位。
建议:先用少量真实业务样本分别跑 LOW、MEDIUM 和默认 HIGH,再决定线上档位。通过 API易 apiyi.com 注册即可获得免费测试额度,一个 API Key 就能在 Neon、Hydrogen、Carbon 之间切换对比。
Gemini 4 Neon 与 Carbon、Hydrogen 思考等级对比
很多人踩坑的原因,是默认 Gemini 4 系列共用同一套档位。根据 AI Studio 最新模型页,事实并不是这样:

| 模型 | 思考等级 | 默认档 | 是否有 xhigh | 可用平台 |
|---|---|---|---|---|
| gemini-4-neon | low / medium / high / xhigh | high | 有 | API易、Google 官方 |
| gemini-4-hydrogen | low / medium / high / xhigh | high | 有 | API易、Google 官方 |
| gemini-4-carbon | low / medium / high | medium | 没有 | API易、Google 官方 |
档位差异解读
Carbon 对标分析:Carbon 的默认档是 medium,最高档是 high,没有 xhigh。如果把一份为 Carbon 写的配置(例如“默认 medium,重活开 high”)直接套到 Neon 上,那么 Neon 的“重活”只会用到中间档,真正需要 XHIGH 的证明类任务反而达不到最高强度。反过来,把 Neon 的 xhigh 传给 Carbon,也不在它支持的取值范围内。
Hydrogen 对标分析:Hydrogen 和 Neon 一样有四档,默认也是 high,所以两者之间的档位配置可以互相参考。但档位名称相同,并不代表同一档的思考深度和成本相同,切换模型后仍然需要重新评估。
Antigravity 的情况:在 Antigravity 界面里,xhigh 显示为 Extra,CLI 中仍然写作 xhigh。它的上下文上限是 512K,而 API 的上下文窗口是 1,048,576 token,两者不是同一个窗口。因此在 IDE 里获得的体验,不能直接用来估算 API 调用的长上下文表现。
对比说明:三款模型都可以通过同一个端点
https://api.apiyi.com/v1调用,只需更换model字段。建议在各自支持的档位范围内单独测试,不要跨模型照搬档位配置。
Gemini 4 Neon 价格与端点核对
选择档位时一定会关心单价。下表是 2026-11-20 核对的 API易 价格,单位都是美元 / 百万 token。数据来源有两个:API易 apiyi.com 的模型总表 docs.apiyi.com/models.md(更新于 2026-11-19 10:59,UTC+8),以及定价接口 https://api.apiyi.com/api/pricing(版本 shell-api-modelmak-v1,其中 model_ratio 为 1 时对应输入 $2 / 百万 token)。
| 模型 ID | 输入 | 缓存读 | 输出 | 备注 |
|---|---|---|---|---|
gemini-4-neon |
$3 |
$0.15 |
$15 |
定价接口 model_ratio 1.5、completion_ratio 5、cache_ratio 0.05,与 Google 标价一致 |
gemini-4-hydrogen |
$1.5 |
$0.075 |
$7.5 |
同样是四档,默认 high |
gemini-4-carbon |
$2 |
$0.1 |
$10 |
与 Google 截至 2026-11-30 的介绍价一致;12 月 1 日起 Google 标准价为输入 $4、输出 $20 |
需要注意,gemini-4-neon 在该版本的模型总表中还没有列出,但定价接口已经有对应条目,换算后的价格和 Google 公告一致。核对价格时建议以定价接口为准。对 Neon 来说,输出单价 $15 同样适用于思考 token,所以档位越高,这一列的影响就越大。
常见问题 FAQ
Q1: Gemini 4 Neon 的思考等级是什么?
思考等级决定模型在给出最终答案前进行多少内部推理。Neon 提供 LOW、MEDIUM、HIGH、XHIGH 四档,默认 HIGH。思考产生的 token 按输出价格计费,所以档位同时影响答案质量和成本。
Q2: Gemini 4 Neon 和 Carbon 的思考等级有什么区别?
Carbon 只有 low、medium、high 三档,默认 medium,没有 xhigh;Neon 有四档,默认 high。两者的档位体系不同,配置不能直接复制。Hydrogen 的档位与 Neon 相同,也是四档、默认 high。
Q3: 为什么我的 Gemini 4 Neon 请求返回 HTTP 400?
最常见的原因是请求里仍然使用了旧的 `thinking_budget` 参数,或者把档位设成了 `MINIMAL`。官方文档明确说明这两种写法在 Neon 上都会返回 HTTP 400。改用 LOW 到 XHIGH 中的某一档即可。
Q4: Gemini 4 Neon 的每个思考等级分别适合什么任务?
– **LOW**:工单分类、请求路由、批量摘要等高吞吐任务
– **MEDIUM**:日常编码、基于文档的问答
– **HIGH**:Agent 多步工具调用、复杂图文多模态分析
– **XHIGH**:数学证明、科学数据分析、最重的多文件工程
Q5: 如何通过 API 快速调用 Gemini 4 Neon 并设置思考等级?
1. 访问 API易 apiyi.com 注册账号,获取 API Key 和免费测试额度
2. 将 SDK 的 `base_url` 设为 `https://api.apiyi.com/v1`,`model` 设为 `gemini-4-neon`
3. 按任务类型传入思考等级,例如分类任务用 `low`
同一个 Key 也可以调用 Hydrogen 和 Carbon,方便在各自的档位范围内对比效果。
Q6: Gemini 4 Neon 设置思考等级有哪些限制?
– **成本**:思考 token 按输出单价 `$15` / 百万 token 计费,高档位会显著增加输出用量
– **参数**:不支持 `thinking_budget` 和 `MINIMAL`
– **上下文**:Antigravity 中的 512K 上限与 API 的 1,048,576 不是同一个窗口
– **节省幅度**:官方没有给出各档 token 消耗的固定比例,需要用自己的业务样本测量
Q7: 不确定任务复杂度时,应该选哪一档?
保留默认的 HIGH,并记录输出 token 用量。等数据显示某类任务在 MEDIUM 或 LOW 下质量没有下降时,再针对这一类任务降档。把 XHIGH 设为默认值通常没有必要。
Gemini 4 Neon 思考等级核心要点 Key Takeaways
- 默认是 HIGH:不传参数时,Neon 就按多步工具调用的强度思考
- 分类路由用 LOW:高吞吐的打标签、路由、摘要任务,官方推荐 LOW
- XHIGH 留给最重的任务:只用于证明、科学分析和多文件工程
- 不要照搬 Carbon 的配置:Carbon 只有三档,默认 medium,没有 xhigh
- 旧参数会报错:
thinking_budget和MINIMAL会返回 HTTP 400 - 思考按输出计价:档位越高,最贵的输出 token 越多
- 先测再定:在 API易 apiyi.com 用同一个 Key 对比不同档位的效果和用量
总结
Gemini 4 Neon 思考等级的核心要点:
- 按任务选档:LOW 用于分类、路由、摘要,MEDIUM 用于编码和问答,HIGH 用于多步工具和多模态,XHIGH 只留给最重的任务
- 警惕默认值:默认就是 HIGH,高吞吐任务需要主动降档
- 档位不跨模型通用:Neon 与 Hydrogen 是四档,Carbon 是三档,各自单独配置
够用就停的意思是:先用默认档跑通业务,再根据输出 token 日志逐类下调,而不是一开始就把所有请求开到最高。推荐在 API易 apiyi.com 用免费额度对 LOW、MEDIUM、HIGH 做一轮对比,再确定线上配置。
📚 参考资料
-
Google Cloud – Gemini 4 Neon 模型指南:思考等级、默认档、报错说明与适用场景
- 链接:
docs.cloud.google.com/gemini-enterprise-agent-platform/models/guides/gemini-4-neon - 说明:本文四档对应关系与 HTTP 400 说明的主要依据(2026-11-19)
- 链接:
-
Google AI Studio 最新模型页:Carbon、Hydrogen 的档位与默认值
- 链接:
aistudio.google.com - 说明:用于确认不同 Gemini 4 模型的档位差异
- 链接:
作者:APIYI 技术团队
技术交流:如果在配置 Gemini 4 Neon 思考等级时遇到问题,欢迎通过 API易 官网首页联系我们
