Gemini 4 Hydrogen API

Gemini 4 Hydrogen 要点

发布日期

2026-11-12 发布并直接开放：Gemini API 和 AI Studio 的所有层级（含免费层）、Android Studio、Gemini 企业版；Gemini 应用（免费用户由自动选模型决定是否用到）；搜索对所有用户开放；Antigravity、Chrome 和 Google 表格里的 Gemini 面向 Google AI Pro 与 Ultra 订阅

官方定位

快速、高效，面向日常编码和 agent 工作流，是 Google 推荐的 Gemini 3.8 Flash 及更早型号的升级版。Google 称默认 high 档完成任务比 3.8 Flash 快 2.5 倍，编造内容减少 5 倍以上；推荐的搭配是 Carbon 做规划，Hydrogen 改代码、跑测试

上下文与输出

上下文 1,048,576 token，输入、思考和输出共用；同步请求最多输出 65,536，开启 long decode（后台模式）可到约 1M。输入支持文本、图片、音频、视频和 PDF，输出为文本；知识截止 2026 年 3 月

Thinking 档位

low / medium / high / xhigh 四档，API 默认 high；xhigh 是新增的最高档，Google 建议只在 high 不够用的多步难题上使用。不再接受 minimal（会报错）。思考 token 按输出价计费，max_output_tokens 同时限制思考和输出

官方价格

输入 $1.50 / 输出 $7.50 每百万 token，缓存读取 $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 搜索与地图落地、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 列出，表头没有标注各模型的 thinking 档位；“—”表示 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%。终端类 agent 任务 Sonnet 5.5 更强（Terminal-Bench 4.0 为 64% 对 54%），电脑操作也是 Sonnet 5.5 领先。对 Terra，Google 的表里 Hydrogen 除 Terminal-Bench-Science 外各项都更高，但 Terra 单价低三分之一。看重终端编码选 Sonnet 5.5；看重多模态、长文档和幻觉率，Hydrogen 更划算。

Thinking 档位怎么选，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%），内部 agent 诚实度评测为 96.7%。以上为 Google 自报。
• Cursor: Cursor 在发布当天接入，称 Hydrogen 在默认档的 CursorBench 得分为 54.3%，Gemini 3.8 Flash 为 39.6%。
• Box: Box CEO 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，主要检查 thinking 档位和 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 的四档 thinking；不传，或者传 minimal、max 等其他值时，一律按 medium。Google API 自己的默认是 high，要和它一致请显式传 "high"。
• max_tokens 不传时默认 65,536，这也是 Wokey 当前的输出上限，暂不支持 long decode 和后台模式。思考 token 计入 max_tokens 并按输出价计费，不要沿用 8,192 这类写死的小上限；想省 token 应该降低 thinking 档位。
• 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" }]
  }'

目录价格快照

价格单位为每 100 万 tokens；实际结算以请求处理时价格为准。

官方价格来源: https://aistudio.google.com/docs/pricing

模型能力

Context

1,048,576 tokens

最大输出

65,536 tokens

Streaming

支持

Tools

支持

Vision

支持

支持接口

/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 Key 配置
• 在 DeepSeek Harness 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• 在 Cherry Studio 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• 在 WorkBuddy 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• 在 OpenClaw 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• 在 Hermes Agent 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• 在 Magpie 中使用 Gemini 4 Hydrogen: OpenAI Chat Completions · Base URL 与 API Key 配置
• OpenRouter 替代方案：Wokey 与 OpenRouter 对比: 对比 token 价格、支付手续费、支持接口和上游来源。
• 可验证 AI API：哪些模型和接口带响应证明: 响应证明目前只覆盖官方直连路由上原样转发的 Claude Messages 和 GPT Responses 响应。

常见问题

相关模型与文档

• Gemini 4 Argon
• Gemini 4 Carbon
• Gemini 3.8 Flash
• API 文档
• 全部模型与价格
• Provider Node