||

Gemini 4 Neon 的上下文有多长?API 写 1M,Antigravity 里是 512K

Gemini 4 Neon 的上下文有多长?API 写 1M,Antigravity 里是 512K

作者注:同一个 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-context-window-api-1m-vs-antigravity-512k-image-0


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-context-window-api-1m-vs-antigravity-512k-image-1


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-context-window-api-1m-vs-antigravity-512k-image-2

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。极简调用只需要三处设置:

  1. 创建客户端:client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")
  2. 指定型号:model="gemini-4-neon"
  3. 发送消息: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”。评审时一眼就能看出这个数字对应哪个表面,后续文档更新时也方便逐条复查。

gemini-4-neon-context-window-api-1m-vs-antigravity-512k-image-3


常见问题 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,576 token,Antigravity 文档最高 512K token
  • 先认入口再写数字:请求从哪个表面发出,就引用哪一份文档
  • 默认思考档是 High:Antigravity 不改设置即为 High,预算按它估
  • 第三方帖子不算规格:工具调用记录不能替代 Google 的窗口说明
  • 型号窗口不可互借:Carbon 的 API 窗口不能套到 Antigravity 的 Neon 上
  • 跨入口复用按小窗口:两边都要跑的流程,统一按 512K 设计
  • 价格以定价接口核对:通过 API易 调用 gemini-4-neon,用 usage 字段校准预算

总结

Gemini 4 Neon 上下文规划的核心要点:

  1. 入口决定窗口:API 表面按 1,048,576 token,Antigravity 表面按最高 512K token,各标各的出处
  2. 核对顺序固定:先确认入口,再确认思考档默认值,最后才把窗口数字写进方案
  3. 用真实用量校准:以返回的 usage 为准,配合分段、摘要和缓存输入控制成本

写 Agent 方案时,把“数字 + 出处 + 入口”写成一个整体,就能避免拿 1M 去规划只给 512K 的入口。推荐通过 API易 apiyi.com 用 gemini-4-neon 跑一份真实材料,拿到用量数据后再定稿,平台提供免费额度和多模型统一接口。


📚 参考资料

  1. Gemini API / Google 公告(2026-11-18):Gemini 4 Neon 统一上下文与 API 标价

    • 说明:1,048,576 token 窗口与输入、缓存输入、输出价格的原始出处
  2. Antigravity 模型文档:Gemini 4 Neon 在 Antigravity 中的上下文与思考档

    • 链接:antigravity.google/docs/models
    • 说明:最高 512K token 与 Low、Medium、High(默认)、Extra 思考档的出处
  3. OrcaRouter 文章(2026-11-19):指出两份文档窗口数字的差异

    • 说明:同时说明了第三方工具调用记录不能当作窗口说明
  4. API易 模型总表与定价接口:型号与价格核对入口

    • 说明:见上文“第三步:核对型号与价格”中的两个地址,gemini-4-neon 以定价接口为准

作者:APIYI 技术团队
技术交流:欢迎在 API易 网站首页联系我们,更多资料可访问 docs.apiyi.com 文档中心

延伸阅读

类似文章