Hermes Agent 中转 API 使用

如果你在国内网络环境下访问 OpenAI、Anthropic 等官方 API 不稳定，可以使用我们提供的中转服务。

什么是中转 API？

中转服务提供 OpenAI、Anthropic 等兼容协议。你可以使用同一个 API Key，按需访问不同协议和不同模型。

第一步：获取中转服务 API Key

访问控制台注册账号、完成充值并创建 API Key。

TokenHub 模型中转服务

在控制台注册并充值后，只需一个 API Key，即可按需访问不同协议、不同模型的接口。

1注册账号并充值

2创建一个 API Key

3接入不同协议和模型

前往控制台注册

第二步：配置 Hermes 使用中转

Hermes 支持通过配置自定义 API 端点来使用中转服务：

bash

# 设置 OpenAI 兼容端点为中转地址
hermes config set providers.openai.base_url https://api.tokenhub386.com/v1

# 设置 Anthropic 兼容端点为中转地址
hermes config set providers.anthropic.base_url https://api.tokenhub386.com

请以控制台 API 文档中对应协议的 Base URL 为准。

Base URL 配置

中转服务使用 OpenAI 兼容格式，只需将 base_url 替换为中转地址即可。同一个中转 API Key 也可以用于 Anthropic 兼容协议。

第三步：设置中转 API Key

将中转服务的 API Key 配置到对应的提供商：

bash

# 运行模型配置
hermes model

# 选择对应的提供商（如 OpenAI）
# 输入从中转服务获取的 API Key（替换原来的官方 Key）

第四步：验证配置

bash

# 启动对话测试
hermes

# 发送一条消息，确认能正常响应

如果对话正常响应，说明中转服务配置成功。

配置完成！

恭喜！Hermes Agent 已通过中转服务连接 AI 模型，网络访问更加稳定。

在对话中快速切换

也可以直接在对话中使用斜杠命令切换：

bash

# 在对话中输入
/model openai:gpt-4o

Hermes 会自动使用配置好的中转端点发送请求。

切换回官方 API

如果想切换回官方 API，只需恢复 base_url：

bash

# 恢复 OpenAI 官方 API
hermes config set providers.openai.base_url https://api.openai.com

# 恢复 Anthropic 官方 API
hermes config set providers.anthropic.base_url https://api.anthropic.com