作者注:同一个 Gemini 4 Neon,Gemini API 公告与 Antigravity 模型文档给出的上下文窗口不同。本文按入口拆开两个数字,并给出 Agent 方案中写窗口数字前的核对顺序。
做 Agent 的团队常把宣传页上的上下文窗口直接写进方案,比如“Neon 支持 1M,整个代码仓库一次塞进去”。到了 Gemini 4 Neon 这一代,这种写法容易出问题。Gemini API 公告写的是 1,048,576 token,Antigravity 模型文档写的是最高 512K token,两个数字都来自 Google,在同一周公布,两边页面也没有互相引用。
这不是哪一方写错了。它们描述的是两个不同的调用表面:一个是直接调用模型的 API,一个是 Antigravity 里的 Agent 入口。方案里该写哪个数字,取决于你的请求实际从哪个入口发出。
核心价值:读完本文,你会知道 Gemini 4 Neon 两个窗口数字各自的出处,也会掌握“先认入口、再看思考档、最后写窗口”的核对顺序。按这个顺序做,就不会拿 1M 去规划一个只给 512K 的入口。

Gemini 4 Neon 上下文窗口核心要点
先把参考资料里能确认的事实放在一张表里。表中的数字都是各自文档的原文,不是推算或测试结果。
| 要点 | 文档原文 | 对方案的意义 |
|---|---|---|
| Gemini API 窗口 | Google 2026-11-18 公告:Neon 统一上下文 1,048,576 token |
直接调 API 时的规划上限 |
| Antigravity 窗口 | Antigravity 模型文档:Gemini 4 Neon 上下文最高 512K token |
在 Antigravity 里跑 Agent 时的规划上限 |
| 思考档 | Antigravity 文档列出 Low、Medium、High(默认)、Extra | 默认就是 High,要先确认再估算 |
| 两份文档关系 | 同一周公布,页面之间没有互相引用 | 不能用一边的数字去推另一边 |
| API 标价 | 输入 $3、缓存输入 $0.15、输出 $15(每百万 token) |
成本估算以 API 入口为准 |
Gemini 4 Neon 两个数字为什么都对
1M 和 512K 都来自 Google 官方,只是写在不同页面上。Gemini API 公告说的是模型在 API 上的统一上下文,原文是 1,048,576 token。Antigravity 模型文档说的是 Neon 在 Antigravity 这个产品里的上下文,原文是“最高 512K token”。两个页面写的是两个表面,各自成立,所以它们并不矛盾。
OrcaRouter 在 2026-11-19 的文章里专门指出了这个差异。文章还提到,社交平台用户 @kimmonismus 在 11 月 18 日贴出过一份工具调用记录。那是第三方帖子,不是 Google 对窗口的说明,不能当作窗口规格引用。写方案时,窗口数字只认 Google 自己的文档页,并且要写清是哪一页。
Gemini 4 Neon 与同系列型号的窗口不要混用
还有一个容易踩的坑是跨型号借数字。Gemini 4 Carbon 的型号页写的上下文也是 1,048,576,但那是 Carbon 在 API 上的窗口,不能拿来套到 Antigravity 里的 Neon 上。同理,Neon 的 API 窗口也不能直接套到 Antigravity 的 Neon 上。数字要同时对上型号和入口两个维度,缺一个都不算核对完成。

Gemini 4 Neon 两个入口对比
下面这张表把两个表面拆开看。表中“规划建议”一列是写方案时的做法建议,不是文档规格。
| 维度 | Gemini API(含 OpenAI 兼容的聚合接口) | Antigravity |
|---|---|---|
| 窗口原文 | 1,048,576 token(Google 公告) |
最高 512K token(模型文档) |
| 出处 | Gemini API / Google 2026-11-18 公告 | antigravity.google/docs/models |
| 思考档 | 以 API 文档的参数为准 | Low、Medium、High(默认)、Extra |
| 计费方式 | 按 token 计费,有缓存输入价 | 以 Antigravity 产品规则为准 |
| 规划建议 | 单次请求可以按长上下文设计,但仍要留余量 | 按 512K 设计,长任务要分段和压缩 |
API 入口对标分析:直接调用 API 时窗口更大,适合一次性放进大批文档、长日志或整段代码做分析。不过窗口大不等于每次都该塞满,输入越长,成本和延迟越高。相比之下,把 API 当作“长材料一次读完”的入口,再配合缓存输入价,更适合离线批处理和检索后的大段分析。
Antigravity 入口对标分析:Antigravity 面向 Agent 工作流,文档给出的窗口是最高 512K。Agent 会在多轮工具调用中不断累积历史,实际可用空间消耗得比单次请求快。对于在 Antigravity 里跑长任务的团队,按 512K 设计分段、摘要和上下文淘汰策略更稳妥,不要按 1M 去估。

Gemini 4 Neon 在 Antigravity 中的思考档
Antigravity 文档列出了四个思考档,默认是 High。很多人没注意到默认值,直接拿窗口上限做预算。下表是按档位整理的规划建议,档位名称和默认值来自文档,建议部分是通用做法。
| 思考档 | 文档标注 | 规划建议 |
|---|---|---|
| Low | 可选 | 适合短链路、确定性强的工具调用 |
| Medium | 可选 | 适合常规编码与多步检索 |
| High | 默认 | 不改设置就是这一档,预算时按它估 |
| Extra | 可选 | 适合难题,预留更多余量与等待时间 |
思考档会影响推理开销和响应时间,具体如何计入上下文与计费,以 Antigravity 文档为准。核对时先确认团队实际使用的档位,尤其是默认的 High,再去决定每一轮能留给历史记录和检索材料的空间。
Gemini 4 Neon 快速上手
第一步:确认你调用的是哪个表面
先回答一个问题:请求到底从哪里发出?如果是在代码里通过 SDK 发请求,你走的是 API 表面,窗口按 1,048,576 规划。如果是在 Antigravity 里让 Agent 干活,你走的是 Antigravity 表面,窗口按最高 512K 规划。一个项目里两种都用的话,方案文档要分两节写,别合成一个数字。
第二步:用 OpenAI 兼容接口发一次请求
走 API 表面时,可以通过 API易 的 OpenAI 兼容接口调用 Neon,型号 ID 是 gemini-4-neon。极简调用只需要三处设置:
- 创建客户端:
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - 指定型号:
model="gemini-4-neon" - 发送消息:
client.chat.completions.create(model="gemini-4-neon", messages=[{"role": "user", "content": "总结这份日志"}])
请求返回后,读 response.usage.prompt_tokens 和 response.usage.completion_tokens,就能拿到这一次的实际消耗。规划窗口时以这个返回值为准,不要靠字数估算。
查看完整的分段调用思路
长材料超出你给自己设定的单次预算时,可以按下面的思路分段:
1. 初始化:`client = OpenAI(api_key=”YOUR_API_KEY”, base_url=”https://api.apiyi.com/v1″)`
2. 设定预算:API 表面可设 `budget = 1048576 * 0.7`;如果同一套逻辑还要在 Antigravity 侧复用,改按 512K 的七成设定
3. 切分材料:把文档按章节或文件切成 `chunks`,每块先用 `usage.prompt_tokens` 试跑一次,记录真实长度
4. 逐段摘要:对每个 chunk 调用 `model=”gemini-4-neon”`,要求输出固定格式的摘要
5. 合并推理:把所有摘要拼成新的 `messages`,再做一次总结或决策
6. 记录用量:每轮把 `prompt_tokens`、`completion_tokens` 写入日志,便于事后核对成本
预算里的七成只是留余量的经验做法,不是文档规定,可以按任务调整。
🚀 快速开始:做方案前,可以先通过 API易 apiyi.com 注册并领取免费测试额度,用
gemini-4-neon跑一份真实材料,拿到usage返回值后再定窗口预算。
第三步:核对型号与价格
价格核对有两个入口:API易 的模型总表 https://docs.apiyi.com/models.md,以及定价接口 https://api.apiyi.com/api/pricing。2026-11-20 核对时,总表最近一次更新在 2026-11-19 10:59(UTC+8),那一版还没列入 gemini-4-neon;定价接口(版本 shell-api-modelmak-v1)里已经有这个型号。查 Neon 价格时,以定价接口为准。
定价接口里 model_ratio 为 1 对应输入 $2/百万 token。gemini-4-neon 的 model_ratio 是 1.5、completion_ratio 是 5、cache_ratio 是 0.05,换算后输入 $3、输出 $15、缓存读 $0.15,和 Google 标价一致。
| 型号 | 输入($/百万 token) | 缓存读 | 输出 | 备注 |
|---|---|---|---|---|
gemini-4-neon |
3 |
0.15 |
15 |
与 Google 标价一致,以定价接口为准 |
gemini-4-carbon |
2 |
0.1 |
10 |
对应 Google 到 2026-11-30 的介绍价 |
gemini-4-hydrogen |
1.5 |
0.075 |
7.5 |
定价接口 |
gemini-4-argon |
2 |
0.1 |
10 |
模型总表 |
| 可用平台 | API易、Google 官方 API | — | — | 调用地址 https://api.apiyi.com/v1 |
Carbon 有一个时间点要留意:Google 自 12 月 1 日起的标准价是输入 $4、输出 $20,介绍价只到 2026-11-30。跨月的成本预算要分两段计算。
💡 选择建议:同一个任务可以先用
gemini-4-neon和gemini-4-hydrogen各跑一遍,对比效果和usage。API易 提供统一的 OpenAI 兼容接口,切换型号只需改model参数。
Gemini 4 Neon 上下文预算怎么写进方案
确认入口和思考档之后,就可以把窗口数字写进方案。下面按常见 Agent 任务给出规划思路。表中“建议策略”是工程做法,不是文档规格。
| 任务类型 | 入口 | 规划上限(文档原文) | 建议策略 |
|---|---|---|---|
| 整库代码分析 | API | 1,048,576 token |
先检索相关文件,再整段送入,保留余量 |
| 长日志排障 | API | 1,048,576 token |
按时间窗口切分,重复前缀走缓存输入 |
| IDE 内多轮重构 | Antigravity | 最高 512K token |
定期摘要历史,淘汰旧工具输出 |
| 多工具 Agent 长任务 | Antigravity | 最高 512K token |
子任务拆分,每段结束写结构化记忆 |
| 跨入口复用同一流程 | 两者都有 | 取 512K 为公共上限 |
按小窗口设计,在 API 侧也能直接跑 |
最后一行最容易被忽略。如果同一套 Agent 逻辑既要在 Antigravity 里跑,又要通过 API 跑,最稳的做法是按 512K 设计公共流程。这样在 API 上也能直接运行,只是没有用满窗口。反过来按 1M 设计,到了 Antigravity 就要重写分段逻辑。
方案里写窗口数字时,建议采用“数字 + 出处 + 入口”的格式,比如“Antigravity 模型文档:Gemini 4 Neon 最高 512K token,默认思考档 High”。评审时一眼就能看出这个数字对应哪个表面,后续文档更新时也方便逐条复查。

常见问题 FAQ
Q1:Gemini 4 Neon 的上下文到底有多长?
看入口。Gemini API / Google 2026-11-18 公告写的是统一上下文 `1,048,576` token;Antigravity 模型文档写的是最高 `512K` token。两个都是 Google 的原文,各自对应不同的调用表面。
Q2:API 的 1M 和 Antigravity 的 512K 冲突吗?
不冲突。两份文档描述的是不同产品表面,同一周公布,页面之间没有互相引用。冲突只会出现在方案里:拿 API 的数字去规划 Antigravity 里的任务,就会出问题。
Q3:网上有人贴的工具调用记录能当窗口依据吗?
不能。OrcaRouter 2026-11-19 的文章提到,@kimmonismus 在 11 月 18 日贴出的工具调用记录是第三方帖子,不是 Google 的窗口说明。窗口数字只引用 Google 的公告和文档页。
Q4:Carbon 也是 1,048,576,能套到 Antigravity 的 Neon 上吗?
不能。Carbon 型号页上的 `1,048,576` 是 Carbon 的 API 窗口。型号不同、入口不同,两个维度都对不上,Antigravity 里的 Neon 仍按其模型文档的最高 512K 规划。
Q5:如何通过 API 快速调用 Gemini 4 Neon?
1. 在 API易 apiyi.com 注册并获取 API Key 和免费测试额度
2. 将 SDK 的 `base_url` 设为 `https://api.apiyi.com/v1`
3. 型号填写 `gemini-4-neon`,读取 `usage` 字段核对实际消耗
这样走的是 API 表面,窗口按 Google 公告的 `1,048,576` token 规划。
Q6:模型总表里找不到 gemini-4-neon,价格以哪里为准?
以定价接口为准。总表 2026-11-19 那一版还没列入这个型号,定价接口已经有了,换算结果是输入 `$3`、缓存读 `$0.15`、输出 `$15`,与 Google 标价一致。需要核对时,直接查询 API易 apiyi.com 的定价接口即可。
Q7:Antigravity 的默认思考档会影响规划吗?
会。文档写明默认档是 High,不改设置就按这一档运行。思考档会影响推理开销和响应时间,预算要按实际使用的档位估算,具体计入方式以 Antigravity 文档为准。
Q8:Gemini 4 Neon 有哪些需要注意的限制?
– 窗口因入口而异,不存在一个通用数字
– 长输入会推高成本和延迟,窗口大也不必每次塞满
– 文档可能更新,方案里的数字要标注出处和核对日期
Gemini 4 Neon 核心要点 Key Takeaways
- 两个数字都是官方原文:API 公告
1,048,576token,Antigravity 文档最高 512K token - 先认入口再写数字:请求从哪个表面发出,就引用哪一份文档
- 默认思考档是 High:Antigravity 不改设置即为 High,预算按它估
- 第三方帖子不算规格:工具调用记录不能替代 Google 的窗口说明
- 型号窗口不可互借:Carbon 的 API 窗口不能套到 Antigravity 的 Neon 上
- 跨入口复用按小窗口:两边都要跑的流程,统一按 512K 设计
- 价格以定价接口核对:通过 API易 调用
gemini-4-neon,用usage字段校准预算
总结
Gemini 4 Neon 上下文规划的核心要点:
- 入口决定窗口:API 表面按
1,048,576token,Antigravity 表面按最高 512K token,各标各的出处 - 核对顺序固定:先确认入口,再确认思考档默认值,最后才把窗口数字写进方案
- 用真实用量校准:以返回的
usage为准,配合分段、摘要和缓存输入控制成本
写 Agent 方案时,把“数字 + 出处 + 入口”写成一个整体,就能避免拿 1M 去规划只给 512K 的入口。推荐通过 API易 apiyi.com 用 gemini-4-neon 跑一份真实材料,拿到用量数据后再定稿,平台提供免费额度和多模型统一接口。
📚 参考资料
-
Gemini API / Google 公告(2026-11-18):Gemini 4 Neon 统一上下文与 API 标价
- 说明:
1,048,576token 窗口与输入、缓存输入、输出价格的原始出处
- 说明:
-
Antigravity 模型文档:Gemini 4 Neon 在 Antigravity 中的上下文与思考档
- 链接:
antigravity.google/docs/models - 说明:最高 512K token 与 Low、Medium、High(默认)、Extra 思考档的出处
- 链接:
-
OrcaRouter 文章(2026-11-19):指出两份文档窗口数字的差异
- 说明:同时说明了第三方工具调用记录不能当作窗口说明
-
API易 模型总表与定价接口:型号与价格核对入口
- 说明:见上文“第三步:核对型号与价格”中的两个地址,
gemini-4-neon以定价接口为准
- 说明:见上文“第三步:核对型号与价格”中的两个地址,
作者:APIYI 技术团队
技术交流:欢迎在 API易 网站首页联系我们,更多资料可访问 docs.apiyi.com 文档中心
