跳转到主要内容

核心要点

  • 已上线：谷歌 11 月 12 日发布 Gemini 4 Hydrogen，APIYI 11 月 14 日接入；模型名 gemini-4-hydrogen，default / svip 分组可用，Gemini 原生与 OpenAI 兼容双端点
  • 定价 $1.50 / $7.50（每 1M tokens），缓存读取 $0.075；全 1M 窗口统一价，不是限时优惠，也没有到期日
  • 官方定位是「日常执行档」：由 Carbon 改编、替代 3.8 Flash；默认 high 思考下比 3.8 Flash 快 2.5 倍，Terminal-Bench 4.1 拿到 57%（3.8 Flash 18.2%），虚构声明减少 5 倍以上
  • 1M 统一窗口 + 四档思考：输入、思考、输出共用 1,048,576 tokens；同一次同步请求最多输出 65,536 tokens，更长输出走长解码；thinkingLevel 支持 low / medium / high / xhigh，默认 high
  • 上线前实测：双端点、流式、函数调用（含 thoughtSignature 回传）、JSON Schema、图片、PDF、音频、视频、32.6 万 tokens 找针与 6 并发全部通过

背景介绍

Gemini 4 家族在三周内连发三款：Argon 主打长程任务（10 月 13 日开放）、Carbon 主打最难题（11 月 10 日开放），Hydrogen 则在 11 月 12 日补上「日常执行」这一档。它没有沿用 Flash 品牌，但谷歌给 3.8 Flash 用户的升级建议就是切到 Hydrogen。 Hydrogen 由 Carbon 改编而来，取舍很明确：不追求单题的最深推理，而是把每一步做快、做稳、做便宜。官方给它的场景是写代码、调工具、跑测试、读文档这类高频 agent 循环，而不是跨天的架构设计。谷歌同时给出了配套打法 Orchestrator：让 Carbon 先探索、规划，再交给 Hydrogen 执行；官方称任务成功率接近 Carbon，配额少用 24%、平均快 19%。 APIYI 在发布两天后完成接入。模型走与 Gemini 4 其它成员一致的接入方式，原生端和 OpenAI 兼容端都能直接用。

详细解析

官方基准

以下为谷歌公布数据，未经 APIYI 独立复现： 安全侧，谷歌称 Hydrogen 在 agent 任务中的过度执行减少最多 81%、服务不足减少最多 79%，工具调用与编码评测里的错误动作减少 12 倍，对间接提示词注入的抵抗力提升 2.3 倍以上。这些同样是官方口径，实际部署仍要按业务加护栏。

四个思考档位

thinkingLevel 是 Hydrogen 最主要的成本与延迟旋钮，四档各有明确分工：
  • low：最少 token、最低延迟，适合高吞吐的抽取、分类与短问答
  • medium：交互式编码、实时 UI 原型、对延迟敏感的工具调用
  • high（默认）：复杂编码、agent 执行、工具调用与多模态文档工作
  • xhigh：Hydrogen 新增，留给 high 仍不够用的多步难题；官方提醒它会在简单题上「过度思考」，白付延迟和 token
迁移注意：3.8 Flash 的默认档是 medium，Hydrogen 默认 high；minimal 不再支持（原生端直接报错），thinkingBudget 已废弃，和新档位参数同时传会返回 400。思考 tokens 按输出价计费，档位越高、账单越贵。

1M 窗口与输出上限

输入、思考、输出共享 1,048,576 tokens，全窗口统一计价，没有长上下文加价。同步单次请求最多输出 65,536 tokens；官方称通过长解码（background / 续写）可以继续往上，最高到 1M。 我们在 APIYI 上用一份 52 万字符的文档做了找针：promptTokenCount 为 326,238，模型准确找回埋在文中的编号，耗时 29.7 秒。1M 满窗本次未测，建议先用 20 万至 30 万 tokens 的小样本验证自己的文档形态，再往上放量。

API 层面的变化

从 3.8 Flash 迁移过来，有四处需要改代码或改预期：
  • 采样参数被忽略：temperature、top_p、top_k 传了不报错，但服务端不生效。依赖低温度稳定输出的流程要改用提示词与结构化输出约束。
  • 显式缓存不支持：cachedContents 不可用，只有 ≥4,096 tokens 的隐式前缀缓存；命中由上游按前缀判断，不保证每次都命中，成本模型建议先按无缓存估算。
  • thoughtSignature 必须回传：多轮对话与工具调用要把上一轮响应里的签名原样带回，否则可能 400；这是 Gemini 4 的通用要求，不是 Hydrogen 独有。
  • 知识截止 2026 年 3 月，时效性要求高的场景仍需接搜索或自带资料。

上线前实测

我们在 APIYI 上用低并发跑了 30 个场景，覆盖双端点、流式、工具、结构化输出、多模态与长上下文，结论如下。 通过的：原生与 OpenAI 两端非流式 / 流式均正常；函数调用能正确产出 get_weather({"city":"北京"})，把工具结果回传后继续作答；JSON Schema 返回合法 JSON；单据 OCR、柱状图读数、PDF 编号抽取、音频编号复述、视频画面读数全部正确；32.6 万 tokens 找针通过；6 并发 6/6 成功。 时延：10 轮交错短请求 P50 3.5 秒；流式首字 7–10 秒，原因是思考阶段不吐字，之后正文才成块返回——前端适合加「思考中」状态，而不是按普通流式预期首字秒回。 一个必须避开的上限坑：思考 tokens 计入 max_tokens。实测给 300 这类小预算时，思考重的请求会直接返回空 content + finish_reason=length；600 以上才稳定出正文。建议客户端默认 max_tokens 不低于 1024，复杂任务给 2048 以上。

价格与可用性

  • 模型名 gemini-4-hydrogen，default / svip 分组可用。
  • 原生端点：POST /v1beta/models/gemini-4-hydrogen:generateContent；OpenAI 兼容端点：POST /v1/chat/completions。
  • 与 Carbon / Argon 的限时价不同，Hydrogen 的 $1.50 / $7.50 是标准价，目前没有到期日。
  • 充值活动可叠加，见 充值活动说明。
模型价格与官网对齐，且可能随官网调整；上表仅供参考，具体以顶部导航「模型价格」栏目为准：模型价格。

总结与建议

Hydrogen 的定位不是「更便宜的 Carbon」，而是默认就要用的执行档：日常编码、工具循环、文档处理、多模态抽取，优先用它；真正难的规划、架构、根因分析再交给 Carbon 或 Argon。 上线初期建议这样用：
  • 档位从默认开始：先跑 high，用评测集确认后再降到 medium / low 省钱，或升 xhigh 换质量。
  • max_tokens 留足：思考算在预算里，短上限会直接得到空响应。
  • 多轮与工具回传签名：把 thoughtSignature 原样带上，避免 400。
  • 长文档先小样本：32.6 万 tokens 已验证，更大规模先做一档压测。
  • 成本按无缓存估算：隐式缓存会命中，但不承诺稳定命中。
模型已经可以在 APIYI 直接调用，接入方式与 Gemini 其它模型一致。
官方来源：blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/、deepmind.google/models/model-cards/gemini-4-hydrogen/；数据获取日期 2026-11-13。