跳到正文

Hermes 接入 ​

U 盘预装版已配置,可直接使用;认领、充值后沿用原配置,无需更换 API 密钥。

自行安装的 Hermes Agent 按下面步骤配置。先准备 API 密钥 和余额,在 模型页 选择支持工具调用、上下文不少于 64,000 token 的对话模型,记下模型 ID 和上下文上限。

本页配置使用普通 HTTPS,不执行客户端 TEE 验证。验证方式见 验证网关。

桌面界面(GUI) ​

从 Hermes 官网 下载桌面版,安装后打开应用。

进入「设置 → 提供方 → 自定义端点」(Settings → Providers → Custom Endpoints),在「添加端点」中填写。已有其他端点时,先点击「新建端点」。

界面字段填写内容
名称、提供商 ID均填 zeroseal
端点 URLhttps://gw.zeroseal.cn/v1
API 模式Chat Completions
默认模型从模型页复制的完整模型 ID
上下文模型页显示的上下文上限,单位为 token
API 密钥在 zeroseal 控制台创建的完整密钥

勾选「用于新对话」,点击「保存」。新建对话,在输入框的模型菜单中选择 zeroseal 下的模型,然后 验证连接。

界面说明见 Hermes Desktop 官方文档。

终端界面(TUI) ​

按 官方安装指南 安装命令行版。退出正在运行的 Hermes 会话,在终端执行:

bash
hermes model

选择 Custom endpoint。API base URL、API key、Model name 和 Context length 分别填写上表中的地址、密钥、模型 ID 和上下文;API protocol 选择 OpenAI Chat Completions。

保存后启动会话:

bash
hermes

确认启动信息显示刚选的模型。命令说明见 官方自定义端点指南。

验证连接 ​

在对话框中发送:

text
只回复:连接成功。不要调用工具或读取文件。

收到回复后,到 消费记录 确认调用。仅加载模型列表不能确认密钥和余额可用,仍需完成一次对话。

遇到错误 ​

  • 401:GUI 用户在自定义端点中检查密钥;TUI 用户重新运行 hermes model。确认密钥完整、未删除,且来自国内站。
  • 402:检查 zeroseal 余额是否足够支付本次预扣。
  • 404:检查地址末尾的 /v1、Chat Completions 协议和模型 ID。

其他情况见 错误排查。