Gemini 4 Hydrogen 是什么、怎么接入?官方价格 $1.50/$7.50,在 Claude Code / Codex 里用

Gemini 4 Hydrogen 是 Google 在 2026 年 11 月 12 日(美国时间)正式发布的高效模型,面向日常编程和 agentic 工作流,模型 ID 为 gemini-4-hydrogen。官方 Gemini Developer API 标准价是每百万 token 输入 $1.50、输出 $7.50(含思考 token),隐式缓存 $0.075,免费档这三项标为免费。本文整理官方规格与价格、在 AI Studio / Gemini API 里怎么接,以及在 Claude Code、Codex、Cursor 里的写法。

7 分钟阅读
Gemini 4 Hydrogen 是什么、怎么接入?官方价格 $1.50/$7.50,在 Claude Code / Codex 里用

Gemini 4 Hydrogen 是 Google 面向日常编程和 agentic 工作流的高效模型。据 Google 官方博客(Koray Kavukcuoglu,2026 年 11 月 12 日),它于当天(美国时间)正式发布,对应北京时间约 2026 年 11 月 13 日 02:02。官方模型 ID 是 gemini-4-hydrogen,上下文 1M,官方 Gemini Developer API 标准价为每百万 token 输入 $1.50、输出 $7.50(含思考 token)。长周期边界推理仍由 Gemini 4 Carbon 和 Gemini 4 Argon 承担。

2026 年 11 月 13 日(北京时间,UTC+8),我们核对本站公开模型目录和 https://api.aicodewith.ai/v1/models:列表里已有 gemini-4-carbon、gemini-4-argon、gemini-3.8-flash、gemini-3-flash-preview,尚未见 gemini-4-hydrogen 或明显等价的模型 ID。用测试 Key 向本站三个常用入口各发一次请求,都返回 HTTP 400,错误是「模型 gemini-4-hydrogen 不存在或未上线」。这台测试机上没有官方 Gemini API Key,所以没有用官方 Gemini API 再跑一遍调用;Claude Code、Codex、Cursor 也没有对着 Hydrogen 实跑任务。下面先按官方文档写 AI Studio / Gemini API 的接入步骤,再给出本站已上架 Gemini 模型在三个客户端里的写法,目录出现 gemini-4-hydrogen 后把模型名换过去即可。

创建 API Key →

先看结论

问题答案
Hydrogen 是什么?Google 面向日常编程和 agentic 工作流的高效 Gemini 4 模型。Carbon / Argon 仍是长周期边界推理。
模型 IDgemini-4-hydrogen
官方标准价(每百万 token,USD)输入 $1.50;输出(含思考 token)$7.50;隐式缓存 $0.075。不支持显式缓存。
免费档官方价格页给输入、输出、隐式缓存标的是 Free of charge;Search / Maps Grounding 在免费档不可用。
上下文和输出上下文 1M。官方模型页写 Max output 65K / 1M tokens;模型卡 写默认同步输出最多 64K,后台 long decode 可到 1M。
思考档位官方为 low、medium、high(默认)、以及新增的 xhigh。
现在怎么接?用官方 AI Studio 或 Gemini API,模型名填 gemini-4-hydrogen。本站目录截至本跑时尚未见此模型 ID;本站已上架的是 Carbon、Argon 和 3.8 Flash 等 Gemini 模型。

Gemini 4 Hydrogen 是什么

据 官方发布博客 和 开发者公告:

  • Hydrogen 定位是把 Gemini 4 级别的能力带到更日常的编码和 agentic 工作流,强调速度和效率。
  • Carbon 和 Argon 仍然用于最难的长周期推理;Hydrogen 可以单独做日常执行,也可以在多模型流程里当高效执行引擎。
  • Google 同时在 Antigravity 里推出 Orchestrator:同一会话里在 Carbon 和 Hydrogen 之间切换。官方称,在 Terminal-Bench 4.0 上,Orchestrator 的成功率接近 Carbon,平均少用 24% 配额、快 19%。
  • 可用面:Google AI Studio 所有档、Gemini API、Gemini for business、Gemini 应用、Google Search,以及付费 Google AI Pro / Ultra 订阅者在 Google Antigravity 中使用。Gemini 应用的免费用户会通过自动模型选择,在适合的提示下用到 Hydrogen。
  • 可直接在 AI Studio 里试用。更完整的安全与评测说明见官方 Gemini 4 Hydrogen 模型卡(2026 年 11 月 12 日发布)。模型卡还写了知识截止日期为 2026 年 3 月,部分领域可能更旧。

@GoogleDeepMind、@GeminiApp 和 @GoogleAIStudio 在发布当天同步做了宣布。据 9to5Google 报道,Gemini 应用模型选择器里把 4 Hydrogen 标成 Everyday help。

规格速查

以下整理自官方 模型页、价格页、思考档位文档 和 模型卡,数字以官方原文为准。

项目官方说明
模型名Gemini 4 Hydrogen
Gemini API 模型 IDgemini-4-hydrogen
上下文1M tokens
最大输出官方模型页:65K / 1M tokens。模型卡:默认同步最多 64K,后台 long decode 可到 1M。
输入模态文本、图像、音频、视频、PDF
思考档位low、medium、high(默认)、xhigh(Hydrogen 新增;Carbon / Argon 为 low / medium / high)
缓存只支持隐式缓存,不支持显式缓存
免费档有。价格页给输入、输出、隐式缓存标 Free of charge;Grounding 在免费档不可用。免费档内容可能被用于改进产品,付费档则否(以官方价格页为准)。

官方价格

官方 Gemini Developer API 价格页 按每百万 token、美元计价。下面这组是 Hydrogen 的标准价,不要和 Gemini 3.8 Flash 的 $0.75 / $3.75(官方写明有效期至 2026 年 12 月 31 日)混在一起。

项目免费档付费档(每百万 token,USD)
输入Free of charge$1.50
输出(含思考 token)Free of charge$7.50
上下文缓存Free of charge$0.075,仅隐式缓存;不支持显式缓存

付费档的 Grounding with Google Search / Maps:Gemini 3 及更新模型共享每月 5,000 次免费请求,之后每 1,000 次 $14。Search Grounding 另有每天 1,500 次上限。官方说明:一次用户请求可能触发多次搜索,按实际查询次数计费。价格页还写明:模型处理的每个 token 都会计数并计费,包括思考 token,以及使用 Grounding 时的内部工具系统说明和函数声明。

本站目录截至本跑时尚未见 gemini-4-hydrogen。同一时间目录里已经上架的 Gemini 模型是 gemini-4-carbon、gemini-4-argon、gemini-3.8-flash 和 gemini-3-flash-preview,用法见下文客户端配置。

官方公布的基准

以下全部是 Google 官方发布博客和模型卡里的数字,不是我们复测。测试设置和第三方评测不一定相同,只作对照。

据 官方博客:

  • Artificial Analysis Intelligence Index:默认 high 为 51,对照 Argon 的 50;xhigh 档达到 54。
  • 默认 high 下,完成任务比 Gemini 3.8 Flash 快 2.5 倍。
  • Terminal-Bench 4.1:57%,对照 3.8 Flash 的 18.2%。
  • 官方称虚构陈述(fabricated claims)下降超过 5 倍。
  • Antigravity Orchestrator 在 Terminal-Bench 4.0 上成功率接近 Carbon,平均少用 24% 配额、快 19%。

博客还提到它在 Agent Arena 排第 5,HLE-Diamond 为 58.8%,Vals Tax Agent Bench 为 52.3%,Vals Legal Research Bench 为 55.8%,Multimodal Knowledge Agent(MKA)为 53.4%。更完整的对照表在 模型卡 和 评测方法说明。

怎么用官方 Gemini API / AI Studio 接入

这是现在就能用 Hydrogen 的路径。步骤按官方 快速开始、思考档位文档 和 What's new 整理,我们没有用官方 Key 实跑这些命令。

  1. 在 Google AI Studio 创建 API Key,也可以直接打开 Hydrogen 对话 先试用。
  2. 安装官方 SDK:Python 用 google-genai,JavaScript 用 @google/genai。把 Key 放到环境变量 GEMINI_API_KEY。
  3. 请求里的模型名填 gemini-4-hydrogen。官方当前推荐的 Interactions API 示例如下。

Python:

python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Explain how AI works in a few words."
)
print(interaction.output_text)

REST(官方快速开始里的写法):

bash
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Explain how AI works in a few words"
  }'

思考档位用 generation_config.thinking_level 控制。官方默认是 high;更难的多步编码和 agent 任务可以设 xhigh,对延迟和 token 用量敏感的任务用 low 或 medium。官方文档提醒:在简单的文本或 JSON 抽取上使用 xhigh,可能想得过深,或把 max_output_tokens 用完。文档里的 Python 写法是:

python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
    generation_config={
        "thinking_level": "xhigh"
    }
)
print(interaction.output_text)

在 Claude Code / Codex / Cursor 里怎么用

三个客户端并列,选你平时用的即可。本站目录截至本跑时尚未见 gemini-4-hydrogen 此模型 ID,所以下面的配置不能拿来假装已经在这些客户端里跑通了 Hydrogen。它们适用于本站已上架的 Gemini 模型;等目录出现 gemini-4-hydrogen 后,把模型名换成它即可。完整的 Codex 字段说明见《Codex 接入 AI Code With》和《Codex config.toml 配置指南》,Claude Code 见《Claude Code 第三方 API 配置》。

我们这次实际看到的结果是:

  • GET https://api.aicodewith.ai/v1/models 返回 61 个模型,其中 Gemini 相关为 gemini-4-carbon、gemini-4-argon、gemini-3.8-flash、gemini-3-flash-preview,没有 Hydrogen。
  • 站点公开目录同样没有 Hydrogen。
  • 分别向 https://api.aicodewith.ai/v1/chat/completions、https://api.aicodewith.ai/chatgpt/v1/chat/completions 和 https://api.aicodewith.ai/v1/messages 发送 model 为 gemini-4-hydrogen 的最小请求,三次都在约 0.1 到 0.2 秒内返回 HTTP 400,错误信息为「模型 gemini-4-hydrogen 不存在或未上线,请前往 https://aicodewith.ai/zh/dashboard/pricing 查看可用模型列表」。

Claude Code 写 ~/.claude/settings.json,启动时再指定一个本站已上架的模型,例如 gemini-4-argon:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 AICodeWith API Key"
  }
}
bash
claude --model gemini-4-argon -p "Reply with exactly: pong"

Codex 写 ~/.codex/config.toml。base_url 必须是 https://api.aicodewith.ai/chatgpt/v1,不要写成 /v1。用全局的 experimental_bearer_token,name 写成 "aicodewith":

toml
model_provider = "aicodewith"
model = "gemini-4-argon"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "你的 AICodeWith API Key"
bash
codex exec --skip-git-repo-check "Reply with exactly: pong"

Cursor 可以在模型设置里填自定义 API 和模型名。这条路径我们没有实跑,配置是否能连上要以你本机的 Cursor 版本为准。目录出现 Hydrogen 之后,模型名同样填 gemini-4-hydrogen。

如果要用官方协议走 Gemini 原生接口,本站文档给出的 Base URL 是 https://api.aicodewith.ai/gemini_cli,请求形如 POST https://api.aicodewith.ai/gemini_cli/v1beta/models/{model}:generateContent,鉴权用 Authorization: Bearer 加上本站 Key。这条路目前同样只能填目录里已经有的 Gemini 模型 ID,不能指望现在就把 {model} 写成 gemini-4-hydrogen。

想先在本站用其他 Gemini 模型,或等 Hydrogen 上架后再切模型,可以先创建一个本站 API Key。

创建 API Key →

常见报错与解法

报错 / 现象原因解法
模型 gemini-4-hydrogen 不存在或未上线(HTTP 400)本站目录里还没有这个模型 ID(我们 2026-11-13 实测遇到)先查本站模型列表或定价页;当前要用 Hydrogen,走官方 AI Studio / Gemini API;本站可先用已上架的 gemini-4-argon、gemini-4-carbon 或 gemini-3.8-flash
Codex 提示模型不存在,但你写的是已上架模型base_url 写成了 https://api.aicodewith.ai/v1改成 https://api.aicodewith.ai/chatgpt/v1
官方 SDK 或 curl 返回 400 / 403Key 没设、设错,或请求没有打到官方 Gemini 入口确认环境变量是 GEMINI_API_KEY,REST 走 https://generativelanguage.googleapis.com/v1beta/interactions,并带 x-goog-api-key
把本站 Key 填进官方 generativelanguage.googleapis.com,或把官方 Gemini Key 填进本站入口两套凭证和两套入口不能混用官方 Key 只用于 Google 的 API;本站 Key 只用于 api.aicodewith.ai
输出被截断,或简单抽取任务又慢又长thinking_level 设成了 xhigh,或 max_output_tokens 太小按官方文档:简单任务用 low 或 medium,并给够 max_output_tokens
Gemini 原生请求打到 /v1/chat/completions 后行为不符合预期本站 Gemini 原生协议走的是 /gemini_cli,不要和 OpenAI 入口混填需要 generateContent 时,Base URL 用 https://api.aicodewith.ai/gemini_cli

FAQ

Hydrogen 和 Carbon、Argon 怎么选?

据官方博客:日常编码、跑测试、快速改仓库,优先看 Hydrogen;最难的长周期推理和架构判断,仍用 Carbon 或 Argon。官方还把 Hydrogen 当作从 Gemini 3.8 Flash 升级的主力日常模型。三者的对比可以继续看《Gemini 4 Carbon 测评》和《Gemini 4 Argon 上手》。

官方价格是 $1.50 / $7.50,会不会和 3.8 Flash 搞混?

不会是同一组价。Hydrogen 付费档标准价就是每百万 token 输入 $1.50、输出 $7.50。Gemini 3.8 Flash 官方现价是 $0.75 / $3.75,有效期写到 2026 年 12 月 31 日,之后才是 $1.50 / $7.50。看价格页时要对着模型 ID 核对。

现在能在 Claude Code 或 Codex 里直接选 Hydrogen 吗?

走官方 Gemini API / AI Studio 可以,模型名就是 gemini-4-hydrogen。走本站 API 时,截至本次核对,目录里还没有这个模型 ID,强行填写会看到上面的 HTTP 400。本站已经可以选 Carbon、Argon 或 3.8 Flash。

免费档能用吗?

据官方价格页,Hydrogen 在免费档提供输入、输出和隐式缓存,标为 Free of charge;Search / Maps Grounding 在免费档不可用。免费档的用量和速率限制以官方当时公布的为准,并且免费档内容可能被用于改进产品。

资料

创建 API Key →