博客

Gemini 4 Hydrogen API 发布了:gemini-4-hydrogen 的价格、四个思考档和怎么调用

先说结论

谷歌在 2026 年 11 月 12 日正式发布了 Gemini 4 Hydrogen,模型 ID 是 gemini-4-hydrogen。这是 Gemini 4 系列里第一个走「快、便宜、能干活」这一档的模型,谷歌自己说它是 Gemini 3.8 Flash 的推荐升级替代。

关键数字,全部来自谷歌官方:

  • 官方价:每百万 token 输入 $1.50、输出 $7.50,有免费层。
  • 上下文:100 万 token,输入、思考、输出共用一个窗口。
  • 思考档位:low / medium / high(默认)/ xhigh,新增了 xhigh。
  • 多模态:文字、图片、视频、音频、PDF 输入,文字输出。

TeamoRouter 上还没有 gemini-4-hydrogen。 谷歌发布了,但还没进我们的模型目录。等它上架之后,用你现在这个 Key、把 model 换成 gemini-4-hydrogen 就能调,Base URL 不用动。现在要先用,可以先用 Gemini 4 Argon(gemini-4-argon)或 Gemini 4 Carbon(gemini-4-carbon),这两个在 TeamoRouter 上都能用。

这个模型是什么定位

谷歌给 Hydrogen 的定位很明确:把 Gemini 4 的智能做到便宜、快,给日常写代码和 agent 用。

它和 Carbon、Argon 是同一个架构——同样的 100 万统一上下文、同样的长输出(long decode)能力、同样的内置工具。区别在每轮花多少思考 token,也就是「想多久」。

谷歌写的一句话很直白:「推荐从 Gemini 3.8 Flash 和更早的 Gemini 3、2.5 模型升级上来。」 也就是说,它接的是 Flash 那一档的班。

谷歌公布了什么能力

以下全部来自谷歌官方的 What's new in Gemini 4 Hydrogen 和 模型页。

  • 写代码更靠谱:谷歌说它写出来的代码更干净,编造内容的量比 Gemini 3.8 Flash 少了 5 倍以上——做法是缺上下文时明确说出来,而不是猜。
  • 工具调用更快:读文件的调用和搜索的调用会并行发出去,工具调用失败时也更能自己调整。
  • 四个思考档:low、medium、high(默认)、xhigh。这是 Gemini 4 Hydrogen 第一次引入 xhigh。
  • 适合多模型协作:可以单独用,也可以和 Carbon、Argon 搭配——Carbon 负责规划和攻坚,Hydrogen 并行跑子任务。
  • 多模态更强:读表格、图表、密集 PDF、图片、音频、视频更准;支持逐帧检查视频里的具体画面。
  • 100 万上下文 + 长输出:输入、思考、输出共用一个 1,048,576 token 的窗口;输出默认同步最多 65,536 token,开长输出(long decode)可以一路到 100 万。
  • 成了 Antigravity agent 的默认模型:在 Gemini Managed Agents 里,Antigravity agent 现在默认用 Hydrogen。

也有些不支持的能力,官方模型页写得很清楚:不支持图片生成、不支持 Live API、不支持音频生成。上下文缓存只支持隐式(implicit),显式缓存(explicit caching)不支持。

价格

谷歌官方价,每 100 万 token,美元:

免费层 标准(付费层)
输入 免费 $1.50
输出(含思考 token) 免费 $7.50
上下文缓存 免费 $0.075(只支持隐式缓存)

另外三种消耗方式,价格不一样:

方式 输入 输出 缓存
标准 $1.50 $7.50 $0.075
Batch $0.75 $3.75 $0.0375
Flex $0.75 $3.75 $0.0375
Priority $2.70 $13.50 $0.135

注意两点:

  • 思考和工具指令都算 token。 谷歌在价格页特意标了一句:模型处理的每个 token 都计费,包括思考 token,以及用 grounding 时的内部工具系统指令和函数声明。
  • 显式缓存不支持,所以重复输入只能靠隐式缓存命中,命中不了就全额按输入价算。

免费层不提供 Google 搜索 grounding。付费层每月有 5,000 次免费搜索请求(所有 Gemini 3 及更新的模型共用),超出每 1,000 次 $14,每天上限 1,500 次。另外免费层的模型输出会被谷歌用来改进产品,付费层不会。

四个思考档怎么选

这是 Hydrogen 最值得注意的改动。官方的建议很具体:

档位 Token 用量 什么时候用
low 最少、延迟最低 对成本和延迟敏感的活,比如高频聊天、批量处理。agent 任务上也不算差
medium 较少、更快 交互式写代码、实时改 UI 原型、响应要快的聊天和工具调用
high(默认) 智能和速度平衡 大多数任务都用这个:复杂写代码、agent 执行、工具调用、多模态知识工作
xhigh 最多、推理最深 只留给 high 搞不定的硬骨头:多步写代码、复杂的 agent 问题,且你能接受更高的延迟和 token

谷歌的建议是:先都用 high,只有 high 不够时才上 xhigh。 因为 xhigh 在简单问题上会想太多,既慢又贵。正确的做法是在四个档位上各跑一遍你自己的评测(max_output_tokens 给足,别让上限截断答案),然后选达到你质量要求的最低那一档。

Hydrogen、Carbon、Argon 怎么选

三个模型共用同一套 100 万上下文和内置工具,按「要多聪明 / 要多快 / 要多便宜」来选:

Gemini 4 Hydrogen Gemini 4 Carbon Gemini 4 Argon
官方价(每百万输入 / 输出) $1.50 / $7.50 首发 $2 / $10 首发 $2 / $10
定位 快、便宜,能扛复杂 agent 流程 最强,最深的推理 能扛大多数长任务,token 花得比 Carbon 少
适合 日常写代码、交互式网页应用、用工具的 agent、多模态文档、并行子任务 难架构、查 bug、科学推理、安全审计 长周期任务里想省 token 的场景
TeamoRouter 上能不能用 还没有 能 能

谷歌还给了个搭配用法:Carbon 负责规划系统接口、解决卡住的难题,然后把改代码、跑并行子任务、跑测试这些活交给 Hydrogen。 这样贵的模型只用在关键决策上。

在 TeamoRouter 上怎么用(上架后)

现在还不能用。等 gemini-4-hydrogen 进了我们的模型目录,你手上的 Key 和 Base URL 都不用变,只改 model:

python
from openai import OpenAI

client = OpenAI(base_url="https://api.teamorouter.com/v1", api_key="你的 TeamoRouter Key")
resp = client.chat.completions.create(
    model="gemini-4-hydrogen",
    messages=[{"role": "user", "content": "把这个函数里的嵌套循环去掉:..."}],
)
print(resp.choices[0].message.content)

Gemini 原生格式也是同样的地址:

bash
curl https://api.teamorouter.com/v1beta/models/gemini-4-hydrogen:generateContent \
  -H "x-goog-api-key: 你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "用一句话解释什么是上下文窗口"}]}]}'

TeamoRouter 上还没有 gemini-4-hydrogen,上线后同一个 Key 把 model 换成 gemini-4-hydrogen 就行;现在先用 gemini-4-argon。

现在先用什么

  • Gemini 4 Argon(gemini-4-argon):同一代 Gemini 4,TeamoRouter 上已支持。官方首发价 $2 / $10(2026 年 11 月 30 日前),之后 $4 / $20。比 Hydrogen 贵一档,但能干的活更重。见 Gemini 4 Argon API。
  • Gemini 4 Carbon(gemini-4-carbon):同价,主打最强推理和网络安全。见 Gemini 4 Carbon API。
  • Gemini 3.8 Flash(gemini-3.8-flash):价格更低($0.75 / $3.75,2026 年 12 月 31 日前),适合大量、简单的调用。

怎么付费

TeamoRouter 没有订阅:控制台充值余额,$5 起,每次请求按用掉的 token 从余额扣费,支持银行卡,也可以用 USDT、USDC 或 ETH 转账充值。同一个 Key 还能调 Claude 和 GPT 模型。

新账号余额为 0,先充值再调用。 第一次请求前先充值,$5 起。如果请求返回 402(OpenAI 兼容格式为 400)、提示「钱包余额不足」,说明余额为 0,不是 Base URL 或 Key 配错了,充值后重试即可。

常见问题

Gemini 4 Hydrogen 发布了吗?

发布了。谷歌 2026 年 11 月 12 日在 Gemini API 正式开放(GA),模型 ID 是 gemini-4-hydrogen,免费层和付费层都能用。

Gemini 4 Hydrogen 多少钱?

每百万 token 输入 $1.50、输出 $7.50,上下文缓存 $0.075(只支持隐式缓存)。有免费层。Batch 和 Flex 是半价,Priority 是 $2.70 / $13.50。

它和 Gemini 4 Flash 是同一个模型吗?

是同一个。之前 X 上的爆料把这款 Flash 档的 Gemini 4 模型叫作「Hydrogen」,谷歌公布时直接用了这个名字作为正式名字。官方模型 ID 是 gemini-4-hydrogen,不是 gemini-4-flash。 我们之前按爆料做的预热页用的是 gemini-4-flash,已经改成 gemini-4-hydrogen。

它能输出图片吗?

不能。官方模型页写明不支持图片生成、不支持音频生成、不支持 Live API。

支持 Batch API 吗?

支持,半价:输入 $0.75、输出 $3.75。也支持 Flex 和 Priority 推理。显式缓存不支持,只支持隐式缓存。

TeamoRouter 上现在能用 gemini-4-hydrogen 吗?

还不能,谷歌发布了但还没进我们的模型目录。上线后同一个 Key 换模型 ID 就能用。现在可以先用 Gemini 4 Argon 或 Gemini 4 Carbon。

上线后是不是把模型名改一下就行?

是。它走的是标准的 generateContent 路径,和 Gemini 4 Argon、Carbon 一样,不是 Gemini Decision 那种独立接口。所以同一个 Key、同一个 Base URL,只改 model。

相关阅读

准备好接入了吗?登录控制台 · 购买额度 · 创建 API Key,三步即可开始。