> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini 4 Hydrogen 上线：更快更省的 Agent 执行档

> 谷歌 11/12 发布的 Gemini 4 快速档已上线 APIYI：1M 共享窗口、四档思考默认 high，Terminal-Bench 4.1 拿 57%，定价 $1.50/$7.50 每 1M tokens。实测双端点、工具、音视频与 32.6 万 tokens 长文。

## 核心要点

* **已上线**：谷歌 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 独立复现：

| 基准 | 衡量内容 | Gemini 4 Hydrogen |
| - | - | - |
| Artificial Analysis Intelligence Index | 综合智能 | 51（`high`）/ 54（`xhigh`），Argon 为 50 |
| Terminal-Bench 4.1 | 终端 agent 任务 | 57%，3.8 Flash 为 18.2% |
| HLE-Diamond | 高难推理 | 58.8% |
| Agents' Last Exam v1.1 | 长程 agent 任务 | 71.6% |
| AutomationBench-AA | 端到端业务流程 | 76.1% |
| Multimodal Knowledge Agent | 多模态知识工作 | 53.4% |
| Vals Tax Agent / Legal Research | 税务 / 法律研究 | 52.3%（第 1）/ 55.8%（并列第 1） |

安全侧，谷歌称 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 以上。**

## 价格与可用性

| 项目 | 价格（每 1M tokens） |
| - | - |
| 输入 | \$1.50 |
| 输出（含思考） | \$7.50 |
| 缓存读取 | \$0.075（输入价 95% off） |

* 模型名 `gemini-4-hydrogen`，`default` / `svip` 分组可用。
* 原生端点：`POST /v1beta/models/gemini-4-hydrogen:generateContent`；OpenAI 兼容端点：`POST /v1/chat/completions`。
* 与 Carbon / Argon 的限时价不同，Hydrogen 的 \$1.50 / \$7.50 是**标准价**，目前没有到期日。
* 充值活动可叠加，见 [充值活动说明](https://docs.apiyi.com/faq/recharge-promotions.md)。

> [!NOTE]
>
> 模型价格与官网对齐，且可能随官网调整；上表仅供参考，具体以顶部导航「模型价格」栏目为准：[模型价格](https://docs.apiyi.com/models/index.md)。

## 总结与建议

Hydrogen 的定位不是「更便宜的 Carbon」，而是**默认就要用的执行档**：日常编码、工具循环、文档处理、多模态抽取，优先用它；真正难的规划、架构、根因分析再交给 Carbon 或 Argon。

上线初期建议这样用：

* **档位从默认开始**：先跑 `high`，用评测集确认后再降到 `medium` / `low` 省钱，或升 `xhigh` 换质量。
* **`max_tokens` 留足**：思考算在预算里，短上限会直接得到空响应。
* **多轮与工具回传签名**：把 `thoughtSignature` 原样带上，避免 400。
* **长文档先小样本**：32.6 万 tokens 已验证，更大规模先做一档压测。
* **成本按无缓存估算**：隐式缓存会命中，但不承诺稳定命中。

模型已经可以在 APIYI 直接调用，接入方式与 Gemini 其它模型一致。

> [!NOTE]
>
> 官方来源：`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。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.