Hermes 接入
U 盘预装版已配置,可直接使用;认领、充值后沿用原配置,无需更换 API 密钥。
自行安装的 Hermes Agent 按下面步骤配置。先准备 API 密钥 和余额,在 模型页 选择支持工具调用、上下文不少于 64,000 token 的对话模型,记下模型 ID 和上下文上限。
本页配置使用普通 HTTPS,不执行客户端 TEE 验证。验证方式见 验证网关。
桌面界面(GUI)
从 Hermes 官网 下载桌面版,安装后打开应用。
进入「设置 → 提供方 → 自定义端点」(Settings → Providers → Custom Endpoints),在「添加端点」中填写。已有其他端点时,先点击「新建端点」。
| 界面字段 | 填写内容 |
|---|---|
| 名称、提供商 ID | 均填 zeroseal |
| 端点 URL | https://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。
其他情况见 错误排查。