博客

在 Hermes Agent 里用 Gemini 4:一个 API Key 接入 Hydrogen、Carbon 和 Argon

先说结论

Hermes Agent(Nous Research 出品)支持任何 OpenAI 兼容接口,所以可以通过 TeamoRouter 在里面跑 Gemini 4:一个 API Key,不需要谷歌账号。

  1. 运行 hermes model,选 Custom endpoint。
  2. Base URL 填 https://api.teamorouter.com/v1,填你的 TeamoRouter Key,模型填 gemini-4-hydrogen(或 gemini-4-carbon、gemini-4-argon)。
  3. 开始会话。之后用 /model custom:gemini-4-carbon 切换模型。

同一个 Key 在 Hermes 里还能跑 Claude、GPT 等模型,一个会话里就能来回切。

谷歌提示「User location is not supported」? Gemini API 不是所有国家和地区都能用。通过 TeamoRouter,一个 Key 就能调 Gemini 4 Hydrogen、Carbon 和 Argon,不需要谷歌账号——看怎么用,或者直接拿 API Key。

给 Hermes Agent 拿一个 API Key

新账号余额为 $0,第一次请求前先充值。 最低 $5 即可充值。如果请求返回 402(OpenAI 格式下是 400),提示「wallet balance is insufficient」,说明余额为空,Base URL 和 Key 都配对了,充值后重试即可。

为什么是 Hermes Agent 和 Gemini 4

在 OpenRouter 的 Gemini 4 Carbon 应用排行里,Hermes Agent 是用量最大的有名字的应用之一,约 430 亿 token;在 Gemini 4 Hydrogen 应用排行里排第三(2026 年 11 月 18 日读取)。Hermes 是一个长时间运行的个人 / 命令行 agent,带工具、记忆和子代理,正是谷歌做 Gemini 4 时瞄准的那类工作。

配置

还没装 Hermes Agent 的话,用官方脚本安装:

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

然后创建一个 TeamoRouter API Key(以 sk-teamo- 开头)。

方式一:配置向导。 在终端里运行(不要在聊天会话里):

bash
hermes model
# 选 "Custom endpoint (self-hosted / VLLM / etc.)"
# API base URL: https://api.teamorouter.com/v1
# API key:      sk-teamo-...
# Model name:   gemini-4-hydrogen

方式二:改 ~/.hermes/config.yaml。 Hermes 以 config.yaml 作为模型和接口配置的唯一来源:

yaml
model:
  default: gemini-4-hydrogen
  provider: custom
  base_url: https://api.teamorouter.com/v1
  key_env: TEAMOROUTER_API_KEY

再把 Key 写进 ~/.hermes/.env:

bash
TEAMOROUTER_API_KEY=sk-teamo-...

(直接在 config.yaml 里写 api_key: 也可以;用 key_env 是为了不把 Key 写进配置文件。)

会话里切换模型

在 Hermes 聊天里,/model 可以在已经配置好的接口之间切换模型:

text
/model custom:gemini-4-carbon     # 最难的问题
/model custom:gemini-4-hydrogen   # 日常活
/model custom:claude-sonnet-5-5   # 同一个 Key 用 Claude

要加别的服务商,得退出会话、重新运行 hermes model。Hermes 默认也用你的主聊天模型做压缩、看图等辅助任务;可以在 Hermes 配置里把这些任务改到更便宜的模型。

用哪个 Gemini 4 模型

模型 适合干什么 谷歌官方价 输入 / 输出(每百万)
gemini-4-hydrogen 日常 agent 工作;Gemini 4 里最快最便宜 $1.50 / $7.50
gemini-4-carbon 最难的问题 2026 年 11 月 30 日前 $2 / $10;12 月 1 日起 $4 / $20
gemini-4-argon 长的多步骤任务,token 比 Carbon 省 2026 年 11 月 30 日前 $2 / $10;12 月 1 日起 $4 / $20

思考 token 算输出。详细对比见 Gemini 4 Hydrogen、Carbon、Argon 怎么选。

和谷歌原生接口有什么不同

Hermes 有原生的 Gemini 适配,但按它的 Gemini 指南,只有 Base URL 是谷歌自家域名(generativelanguage.googleapis.com)时才用;其他域名上的代理一律按 OpenAI 兼容接口处理。所以通过 TeamoRouter,Hermes 走的是 Chat Completions:

  • 工具调用和流式输出和其他 OpenAI 兼容模型一样能用。
  • 不会用到谷歌 Interactions API 的功能,比如 xhigh 档的超长输出(long decode),单次回答在标准输出上限以内(Gemini 4 是 65,536 token)。

怎么付费

不用订阅:在控制台充值,最低 $5,每次请求按实际用掉的 token 计费。支持银行卡,也支持 USDT、USDC 和 ETH。一份余额 Gemini、Claude、GPT 等都能用。

常见问题

Hermes Agent 支持 Gemini 4 吗?

支持。Hermes 能接任何实现了 /v1/chat/completions 的接口,TeamoRouter 在这个接口上提供 gemini-4-hydrogen、gemini-4-carbon 和 gemini-4-argon。

需要谷歌账号或谷歌 API Key 吗?

不需要,有 TeamoRouter 的 Key 就行。

Base URL 填什么?

https://api.teamorouter.com/v1,provider 设成 custom。

同一个 Key 能在 Hermes 里用 Claude 吗?

能。用 /model custom:claude-sonnet-5-5,或者换成 TeamoRouter 上任何别的模型 ID。

为什么回答没法超过 65,536 token?

超长输出走的是谷歌的 Interactions API,Hermes 只在谷歌自家域名上用它。通过 OpenAI 兼容接口时适用标准输出上限。

相关阅读

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