Gemini 4 Hydrogen API

Gemini 4 Hydrogen 重點

發布

2026-11-12 發布並直接開放：Gemini API 與 AI Studio 的所有方案（含免費方案）、Android Studio、Gemini for business；Gemini 應用程式（免費使用者由自動選擇模型決定是否用到）；搜尋對所有使用者開放；Antigravity、Chrome 中的 Gemini 與 Google 試算表中的 Gemini 提供給 Google AI Pro 與 Ultra 訂閱者

定位

快速、高效，適合日常寫程式與代理工作流程，是 Google 建議的 Gemini 3.8 Flash 及更早型號的升級版。Google 表示預設 high 檔完成任務比 3.8 Flash 快 2.5 倍，捏造內容減少 5 倍以上；建議的搭配是 Carbon 負責規劃，Hydrogen 改程式碼、跑測試

上下文與輸出

1,048,576 token 的上下文視窗，由輸入、思考與輸出共用；同步請求最多輸出 65,536 token，啟用 long decode（背景模式）約可達 1M。接受文字、圖片、音訊、影片與 PDF，輸出為文字；知識截止於 2026 年 3 月

思考等級

low / medium / high / xhigh 四檔，API 預設為 high；xhigh 是新增的最高檔，Google 建議只用在 high 不夠用的多步驟難題。不再接受 minimal（會回傳錯誤）。思考 token 以輸出價計費，max_output_tokens 同時限制思考與輸出

官方價格

每百萬 token 輸入 $1.50 / 輸出 $7.50，快取讀取 $0.075；沒有推廣價，也沒有長上下文加價。Batch 與 Flex 半價，Priority 為 1.8 倍；API 有免費方案（有速率限制）。僅支援隱式快取（至少 4,096 token 的提示）。對照：3.8 Flash 至 2026-12-31 為 $0.75 / $3.75，自 2027-01-01 起為 $1.50 / $7.50

API 功能

支援函式呼叫、結構化輸出、程式碼執行、Google 搜尋與地圖 grounding、URL context、檔案搜尋、computer use、Batch、Flex 與 Priority；不支援 Live API、圖片與音訊生成、顯式快取。temperature、top_p、top_k 會被忽略

訂閱

Antigravity 的模型表把 Hydrogen 列為所有方案可用（含免費方案與 AI Plus），發布文章寫的是付費的 AI Pro 與 Ultra，Antigravity 負責人表示會逐步擴大範圍。Argon 需要 Pro，Carbon 與新推出的 Orchestrator（Carbon 規劃、Hydrogen 執行）需要 Ultra

模型 ID

gemini-4-hydrogen（目前唯一的穩定版）

核對日期 2026-11-13 · 來源: Model card · Gemini API · Model · Gemini API · What’s new · Gemini API · Pricing · Google · Antigravity · Artificial Analysis

官方跑分：Gemini 4 Hydrogen vs Claude Sonnet 5.5 vs GPT-6.1 Terra

資料來自 Google DeepMind 的 Gemini 4 Hydrogen 模型卡（截至 2026 年 11 月），為廠商自測結果，對照模型的分數也由 Google 列出，表頭沒有標示各模型的思考等級；「—」表示 Google 未列出該項。

Google 的表共 10 項，Hydrogen 領先 7 項；Claude Sonnet 5.5 在 Terminal-Bench 4.1（63.9% 對 57.0%）、OSWorld-2.1（83.9% 對 77.6%）與 Terminal-Bench-Science（59.9% 對 51.4%）上較高，GPT-6.1 Terra 在 Terminal-Bench-Science 上也高於 Hydrogen（58.3%）。表中未列出的一行是 Vending-Bench 2 最終餘額：Hydrogen $14,549，Sonnet 5.5 $11,165，Terra $9,107。模型卡沒有與 3.8 Flash 的比較，Google 的發布文章提供了一項：Terminal-Bench 4.1 上 Hydrogen 57%，3.8 Flash 18.2%。

怎麼選：Gemini 4 Hydrogen、3.8 Flash、Argon、Claude Sonnet 5.5 或 GPT-6.1 Terra

比較 Gemini 3.8 Flash：要不要升級

Hydrogen 就是接替 3.8 Flash 的型號。價格上，現在它是 3.8 Flash 的 2 倍（$1.50 / $7.50 對 $0.75 / $3.75）；自 2027-01-01 起 3.8 Flash 漲到相同價格，快取讀取反而更貴（$0.15 對 $0.075）。能力上，Google 表示預設檔完成任務快 2.5 倍，Terminal-Bench 4.1 從 18.2% 提升到 57%；Cursor 測得 CursorBench 從 39.6% 提升到 54.3%；Box 的企業文件評測準確率高 5 個百分點，用時不到一半，token 少約 12%。遷移時更換模型 ID，再留意四點：預設檔從 medium 變成 high；minimal 會回傳錯誤；不再支援顯式快取；輸入與輸出共用一個 1M 視窗。

比較 Gemini 4 Argon 與 Carbon

Artificial Analysis 智慧指數（v5.0.1）中 Hydrogen 預設 high 檔 51 分，高於 Argon 的 50 分，xhigh 檔 54 分；high 檔每項任務成本約為 Argon 的 19%。單價也較低：Argon 與 Carbon 至 2026-11-30 為 $2 / $10，自 12-01 起為 $4 / $20。Carbon 仍是三者中最強的（60 分）。Google 的分工是：Carbon 與 Argon 負責深度、長時程的推理，Hydrogen 負責快速執行；Antigravity 的 Orchestrator 讓 Carbon 規劃、Hydrogen 改程式碼與跑測試，Google 表示成功率接近單用 Carbon，配額少用 24%，快 19%。三者請求格式相同，換模型只需改 ID；Argon 與 Carbon 預設 medium、最高 high。

比較 Claude Sonnet 5.5 與 GPT-6.1 Terra

Google 發布時拿來比較的就是這兩個模型。官方單價：Sonnet 5.5 為 $2 / $10，Hydrogen $1.50 / $7.50，GPT-6.1 Terra $1 / $5。Artificial Analysis 智慧指數 Hydrogen xhigh 檔 54 分，比 Sonnet 5.5（max 檔）低 1 分，每項任務成本約為後者的 32%；AA-Omniscience 幻覺率 Hydrogen 8%，Sonnet 5.5 為 43%。終端機類代理任務 Sonnet 5.5 較強（Terminal-Bench 4.0 為 64% 對 54%），電腦操作也是 Sonnet 5.5 領先。對 Terra，Google 的表中 Hydrogen 除 Terminal-Bench-Science 外各項都較高，但 Terra 單價低三分之一。重視終端機寫程式選 Sonnet 5.5；重視多模態、長文件與幻覺率，Hydrogen 更划算。

思考等級怎麼選，xhigh 值不值得

Google 建議大多數任務使用預設的 high，xhigh 只留給 high 不夠用的多步驟難題，在簡單提示上用 xhigh 會變慢、多花 token，還可能想過頭。Artificial Analysis 四檔實測：low 27 分、每項任務 $0.29，medium 41 分、$0.80，high 51 分、$1.87，xhigh 54 分、$3.16；xhigh 的輸出 token 接近 high 的 2 倍，只多 3 分，Terminal-Bench 4.0 兩檔同為 54%，Terminal-Bench-Science 從 41% 升到 50%。日常寫程式用 high，互動式情境可降到 medium，研究類難題再試 xhigh。透過 Wokey 呼叫時用 reasoning_effort 選檔；不傳時依 medium 處理，想與 Google API 的預設一致就明確傳 high。

官方遷移說明

第三方評測與官方數據

• Artificial Analysis: 智慧指數 v5.0.1 中 xhigh 檔 54 分，在 78 個模型中排第 16，同類中位數 41 分；預設 high 檔 51 分。xhigh 檔跑完整個指數輸出 3.04 億 token（中位數 7,280 萬），屬於非常多話的一檔，每項任務 $3.16、平均 13.5 分鐘；high 檔每項任務 $1.87。輸出速度每秒 190 token，xhigh 檔第一個答案 token 平均 37.77 秒。AA-Omniscience 幻覺率 8%，是有紀錄以來最低的一檔。Artificial Analysis 的評語是「智慧處於領先群，在同價位中定價合理」，但「每項任務比平均慢，而且非常多話」。Wokey 各計費項目均為 Google 定價的 20%，同樣的任務 high 檔約 $0.37，xhigh 檔約 $0.63。
• Google 發布文章: Google 表示 Hydrogen 在預設 high 檔完成任務比 3.8 Flash 快 2.5 倍，Terminal-Bench 4.1 為 57%（3.8 Flash 18.2%），捏造內容減少 5 倍以上；合作夥伴實測比 3.8 Flash 快 2 到 2.8 倍，token 少 12% 到 23%。它在 Agent Arena 排第 5，Vals Tax Agent Bench 排第 1（52.3%），Vals Legal Research Bench 並列第 1（55.8%），內部代理誠實度評測為 96.7%。以上為 Google 自行公布的數據。
• Cursor: Cursor 在發布當天接入，表示 Hydrogen 在預設檔的 CursorBench 得分為 54.3%，Gemini 3.8 Flash 為 39.6%。
• Box: Box 執行長 Aaron Levie 表示，在 Box AI 的複雜工作評測（金融、顧問、生命科學等產業的企業文件任務）中，Hydrogen 的準確率比 Gemini 3.8 Flash 高 5 個百分點，用時不到一半，典型任務的 token 少約 12%。

透過 Wokey 呼叫 Gemini 4 Hydrogen：參數與限制

以下是 Wokey 閘道對 gemini-4-hydrogen 的實際處理方式。從 3.8 Flash、Argon 或 Carbon 切換過來時，除了模型 ID，主要檢查思考等級與 max_tokens。

• 介面為 OpenAI 相容的 /v1/chat/completions：base URL 填 https://api.wokey.ai/v1，API Key 使用 Wokey 的，model 填 gemini-4-hydrogen。opencode、OpenClaw、Hermes Agent 等 OpenAI 相容用戶端都依此設定。
• reasoning_effort 的 low、medium、high、xhigh 直接對應 Hydrogen 的四檔思考等級；不傳，或傳 minimal、max 等其他值時，一律依 medium 處理。Google API 本身的預設是 high，要與它一致請明確傳 "high"。
• max_tokens 不傳時預設 65,536，這也是 Wokey 目前的輸出上限，暫不支援 long decode 與背景模式。思考 token 計入 max_tokens 並以輸出價計費，不要沿用 8,192 這類寫死的小上限；想省 token 應該降低思考等級。
• xhigh 檔思考時間長，Artificial Analysis 測得第一個答案 token 平均約 38 秒。建議開啟 stream: true，並為用戶端保留數分鐘以上的逾時。
• temperature、top_p、top_k 會被 Google 忽略，可以不傳。
• 目前接受文字與圖片輸入；音訊、影片與 PDF 輸入尚未在 Wokey 開放。
• 工具呼叫：請用 tools 欄位宣告工具，不要在提示詞裡讓模型輸出 JSON 形式的工具呼叫（Google 說明這可能回傳 MALFORMED_FUNCTION_CALL）。Hydrogen 回傳的 thought signature 由閘道保存，下一輪照常把 tool_calls 與工具結果傳回即可。
• 結構化輸出：response_format 使用 json_schema，schema 需能轉成 Gemini 的 OpenAPI 子集（type、properties、required、items、enum、description，以及 anyOf 中帶 null 的可空寫法）。json_object，或含 $ref、oneOf、pattern 的 schema，目前會回傳 400 structured_output_supply_unavailable。
• 快取為 Google 的隱式快取，沒有 cache_control 可用；長對話保持前綴穩定即可命中，快取讀取以輸入價的 5% 計費。

透過 Wokey 呼叫 Gemini 4 Hydrogen（/v1/chat/completions）

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer $WOKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-hydrogen",
    "reasoning_effort": "high",
    "stream": true,
    "max_tokens": 65536,
    "messages": [{ "role": "user", "content": "Find the failing test in this repo and fix it" }]
  }'

目錄價格快照

價格以每 1M tokens 計；結算以請求當下的價格為準。

官方價格來源: https://aistudio.google.com/docs/pricing

模型能力

Context

1,048,576 tokens

最大輸出

65,536 tokens

Streaming

支援

Tools

支援

Vision

支援

支援的 API 格式

/v1/chat/completions

傳送請求

/v1/chat/completions

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer $WOKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-4-hydrogen","messages":[{"role":"user","content":"Hello"}]}'

在用戶端中使用 Gemini 4 Hydrogen

閘道位址是 https://api.wokey.ai（OpenAI 相容用戶端通常寫成 https://api.wokey.ai/v1），模型 ID 填 gemini-4-hydrogen。請依你使用的用戶端開啟對應的串接文件。

• 在 opencode 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 DeepSeek Harness 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 Cherry Studio 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 WorkBuddy 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 OpenClaw 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 Hermes Agent 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• 在 Magpie 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 與 API 金鑰設定
• OpenRouter 替代方案：Wokey 與 OpenRouter 比較: 比較 token 價格、付款手續費、API 形式與上游來源。
• 可驗證 AI API：哪些模型與介面帶有回應證明: 回應證明目前只涵蓋官方直連路由上原樣轉發的 Claude Messages 與 GPT Responses 回應。

常見問題

相關模型與文件

• Gemini 4 Argon
• Gemini 4 Carbon
• Gemini 3.8 Flash
• API 文件
• 全部模型與價格
• Provider Node