Gemini 4 Hydrogen：定价与 API 接入指南

Gemini 4 Hydrogen 是什么

一句话：它是 Google 的 Flash 档 Gemini 4 推理模型，模型 ID 为 gemini-4-hydrogen，已在 TokenRa 上线。「Hydrogen」最初是社区代号；模型正式开放后，这个 ID 就是可调用的字符串。

已上线：2026 年 11 月 13 日

一句话：gemini-4-hydrogen 已在 TokenRa 上线，现在就可以调用 /v1/chat/completions。下表是接入前需要知道的全部数据。

推理 token 在 completion_tokens_details.reasoning_tokens 里标出，计入 max_tokens 配额，按输出价计费。

Hydrogen、Argon、Carbon 三者怎么区分

搜 Gemini 4 时会撞见三个名字，定位完全不同：Argon 和 Carbon 是旗舰档，Hydrogen 是 Flash 档。三者不要当成「同一代的三个档位」平均比较，定位不同，价格也不同。

快速开始

三步从零到一次可用调用。模型 ID 是 gemini-4-hydrogen，接口是标准 OpenAI Chat Completions，任何兼容 OpenAI 的客户端改 base URL 即可，请求体不用动。

curl https://tokenra.io/v1/chat/completions \
  -H "Authorization: Bearer $TOKENRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-4-hydrogen","messages":[{"role":"user","content":"用一个例子解释 API 网关的作用"}]}'

• 当前费率：输入 $2.50 / 1M、输出 $7.50 / 1M、缓存输入 $0.10 / 1M token。推理 token 按输出价计费。
• 同一适配器也支持 gemini-3.8-flash，共享参数与限制见 Gemini 3.8 Flash API 文档。

参数与行为

以下是接入前必须知道的行为细节，来自 2026 年 11 月 13 日的真实调用结果。

• 推理模型。先思考再作答，推理文本在 reasoning_details[0] 中返回（format: "google-gemini-v1"）。还有一条 reasoning.encrypted 是谷歌的加密推理载荷，不可读取，不要存储。
• 推理 token 计入 max_tokens。40 个 completion_tokens 里可能有 35 个是 reasoning_tokens。max_tokens 设得太小会导致模型推理完就没额度写正文，返回空 content。给足余量。
• 推理按输出价计费。推理 token 以 $7.50 / 1M token 计费，不是单独的推理费率。在 completion_tokens_details.reasoning_tokens 里可以看到具体数量。
• finish_reason: stop（小写）。网关已规范化为 OpenAI 标准，不需要为 STOP 大写写特判。
• 不支持函数调用。带 tools 字段的请求返回 400，只发纯文本 prompt。
• 客户端超时设 180 秒以上。推理模型可能比普通模型慢，偶发 504 时重试一次。

常见问题

继续了解