| |

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-zh-hant-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-zh-hant-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-zh-hant-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-zh-hant-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 文檔中心

延伸閱讀

Similar Posts