Hermes如何远程API调用

原创

Caihttt

修改于 2026-05-08 02:15:01

2290

文章被收录于专栏：不知道取什么名字的名字不知道取什么名字的名字

本文讲述Hermes如何进行设置，从而实现可以远程调用，基础使用，欢迎各位拓展探讨。

首先我们需要有一台部署了Hermes的服务器，这里直接购买腾讯云轻量应用服务器Hermes应用镜像（当然也可以自行搭建）

需要提前配置好Hermes的模型接入。

下面正式开始：

登录服务器，依次执行命令，注意这里的<your-secret-key>是需要设置的密码，建议设置为复杂密码，后面远程调用需要用到。

hermes config set API_SERVER_ENABLED true
hermes config set API_SERVER_KEY <your-secret-key>
hermes config set API_SERVER_HOST 0.0.0.0

如下图

随后重启hermes (如果提示gateway未安装，执行命令 hermes gateway install 进行安装）

hermes gateway restart

此时，Hermes会监听8642端口

如果你想更改接口，可以执行 hermes config set API_SERVER_PORT <port>，随后重启Hermes（有时候一次重启未生效，可以再次重启）

此时已经设置完成了，我们来进行验证（记得放通对应的端口）

健康检查，其他机器（因为要验证公网访问）执行命令 curl -s http://<服务器IP>:<Port>/health

发送消息验证（your-secret-key是前面设置的信息）

 # Linux的写法，Windows的cmd不支持通过 “\”换行且不支持单引号
 curl http://<服务器IP>:<Port>/v1/chat/completions \
 -H "Authorization: Bearer <your-secret-key>" \
 -H "Content-Type: application/json" \
 -d '{"model": "hermes-agent", "messages": ["role": "user", "content": "<发送的内容>"}]}'

# Windows写法，原单引号内部的双引号需要转义
curl http://<服务器IP>:<Port>/v1/chat/completions -H "Authorization: Bearer <your-secret-key>" -H "Content-Type: application/json" -d "{\"model\": \"hermes-agent\", \"messages\": [{\"role\": \"user\", \"content\": \"<发送的内容>\"}]}"

测试如图：