Docs

接入文档

只改两处：api_key 与 base_url。其余代码保持不动，OpenAI 与 Anthropic 两套 SDK 均可直接使用。

https://api.hermes-router.com/v1 待定网关地址以上线后控制台显示为准

快速开始

三步完成接入，整个过程不需要信用卡。

1
注册账号

邮箱注册，30 秒完成，无需信用卡。
2
创建 API Key

控制台「API 密钥」→「新建」，得到 sk-hr-xxxx。
3
改一行 base_url

任何 OpenAI / Anthropic SDK 都能用，其余代码不动。

from openai import OpenAI

client = OpenAI(
    api_key="sk-hr-xxxxxxxx",          # 你的 Hermes Key
    base_url="https://api.hermes-router.com/v1",  # 只改这一行
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好，Hermes"}],
)
print(resp.choices[0].message.content)

SDK 示例

OpenAI 协议的模型走 /v1；Anthropic SDK 会自行追加路径，base_url 只填主机名。

from openai import OpenAI

client = OpenAI(
    api_key="sk-hr-xxxxxxxx",          # 你的 Hermes Key
    base_url="https://api.hermes-router.com/v1",  # 只改这一行
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好，Hermes"}],
)
print(resp.choices[0].message.content)

import anthropic

client = anthropic.Anthropic(
    api_key="sk-hr-xxxxxxxx",
    base_url="https://api.hermes-router.com",  # 只改这一行
)

msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，Hermes"}],
)
print(msg.content[0].text)

curl https://api.hermes-router.com/v1/chat/completions \
  -H "Authorization: Bearer sk-hr-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"你好，Hermes"}]}'

支持端点

以实际网关为准，上线后以控制台「接入信息」页面所列为准。

待定

方法	路径	协议	说明
POST	/v1/chat/completions	OpenAI	Chat Completions · 最通用，绝大多数工具默认走这里
POST	/v1/responses	OpenAI	Responses API · Codex CLI 使用的新协议
POST	/v1/messages	Anthropic	Messages API · Claude 系列与 Claude Code 使用
GET	/v1/models	通用	列出当前账号可调用的模型名

模型名

模型名与厂商官方一致，不做任何别名或映射：官方文档写什么，这里就填什么。

完整模型列表与价格

例如 gpt-5.6-sol、claude-opus-5。也可以随时 GET /v1/models 拉取当前账号可用的列表。

查看模型与价格 →

工具集成

凡是能自定义 base_url 的工具都能直接接入。下面是最常用的几种。

Claude Code

设置两个环境变量即可，ANTHROPIC_BASE_URL 填 https://api.hermes-router.com（不带 /v1），Token 填你的 Key。写进 shell 配置文件后每次直接 claude。

# Claude Code：两行环境变量，终端里直接 claude
export ANTHROPIC_BASE_URL="https://api.hermes-router.com"
export ANTHROPIC_AUTH_TOKEN="sk-hr-xxxxxxxx"
claude

Codex CLI

在 ~/.codex/config.toml 里添加一个 provider，base_url 填 https://api.hermes-router.com/v1，Key 通过 env_key 指定的环境变量传入。

# Codex CLI：写入 ~/.codex/config.toml
[model_providers.hermes]
name     = "Hermes Router"
base_url = "https://api.hermes-router.com/v1"
env_key  = "HERMES_API_KEY"

model_provider = "hermes"
model          = "gpt-5.6-sol"

# 然后
export HERMES_API_KEY="sk-hr-xxxxxxxx"
codex

Cursor

1. Settings → Models → 打开「Override OpenAI Base URL」
2. Base URL 填 https://api.hermes-router.com/v1，OpenAI API Key 填你的 sk-hr- Key
3. 在模型列表中手动添加需要的模型名后启用

Cline

1. API Provider 选择「OpenAI Compatible」
2. Base URL 填 https://api.hermes-router.com/v1，API Key 填你的 sk-hr- Key
3. Model ID 填模型列表中的名字，例如 claude-opus-5

LangChain

1. ChatOpenAI(model="gpt-5.6-sol", api_key=..., base_url=...)
2. base_url 填 https://api.hermes-router.com/v1
3. ChatAnthropic 同理：base_url 填不带 /v1 的主机地址

错误码

网关返回的 HTTP 状态码与常见原因。响应体里会带请求 ID，排查时请一并提供。

状态码	含义	处理建议
401 Unauthorized	密钥无效	检查 Authorization 头是否为 Bearer + 完整 Key，Key 是否已被删除或禁用。
402 Payment Required	余额不足	前往控制台充值；包月套餐请确认本周期额度尚未耗尽。
404 Not Found	模型不存在	对照模型列表核对 model 名，或确认 base_url 路径是否正确（是否多带 / 少带 /v1）。
429 Too Many Requests	限流	降低并发或按响应头 Retry-After 退避重试；持续触发请联系我们提升配额。
5xx Server Error	上游异常	厂商侧或网关临时故障，建议指数退避重试；持续失败请附请求 ID 联系支持。

常见问题

Hermes Router 是什么？

一个 AI 模型 API 中转平台：你用一个 Key 调用 OpenAI、Anthropic 等厂商的模型，按 token 用量付费；同时提供 Codex 与 Claude Code 两款编程 Agent 的包月套餐。

和直接用官方 API 有什么区别？待定

模型与官方一致，接口协议兼容，价格低于官方（见价格页）。你不需要海外信用卡与多个厂商账号，一份余额通用所有模型。

现有代码要改多少？

只改两处：api_key 与 base_url。OpenAI SDK、Anthropic SDK、LangChain、Cursor、Cline 等凡是能自定义 base_url 的工具都能直接用。

Codex / Claude Code 套餐怎么用？

购买后在控制台拿到专属 Key，按文档里的一条 export（Claude Code）或一段 config.toml（Codex）写入配置，终端里直接启动。

怎么充值？支持哪些支付方式？待定

控制台「充值」页面选择金额支付。支付方式以充值页面显示为准。

余额会过期吗？待定

按量充值的余额不过期；包月套餐按周期计算。

数据安全吗？待定

请求直接转发至厂商 API，平台不存储对话内容；为便于账单核对与故障排查，仅保留调用元数据（模型、token 数、时间）。

调用失败怎么排查？

依次检查：Key 是否正确、余额是否充足、model 名是否在模型列表内、base_url 是否带对路径。仍有问题把请求 ID 发给我们，工程师直接看日志。

没找到答案？联系我们，工程师直接回复。