Hermes Agent 中转 API 使用

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

什么是中转 API?

中转 API 是一个兼容 OpenAI 格式的代理服务,将你的请求转发到官方 API。 Hermes Agent 完全支持自定义 API 端点,配置中转服务非常简单。

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

访问我们的中转服务站点,注册账户并获取 API Key。

中转服务地址

中转服务地址:https://your-relay-domain.com(请替换为实际地址)


第二步:配置 Hermes 使用中转

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

bash
# 设置 OpenAI 兼容端点为中转地址
hermes config set providers.openai.base_url https://your-relay-domain.com

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

请将 https://your-relay-domain.com 替换为实际的中转服务地址。

Base URL 配置

中转服务使用 OpenAI 兼容格式,只需将 base_url 替换为中转地址即可。


第三步:设置中转 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