作者注:同一個 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 文檔中心
