工具接入
Hermes Agent
把 AIPUT 设为 Hermes Agent 的自定义模型端点。
模型调用暂未开放
本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。
需要哪种接口
普通对话（OpenAI Chat Completions）。在模型广场的「端点类型」里选择 Chat。
Hermes Agent 官方要求，带工具的智能体用法需要上下文至少 64K 的模型。选模型时请留意它的上下文长度。
开始之前
另外需要先安装好 Hermes Agent，安装方法见 Hermes Agent 官方文档。
方式一：用命令向导设置
- 在终端运行
hermes model。 - 选择 Custom endpoint。
- 按提示依次填写：API 地址
https://api.aiput.top/v1、你的 AIPUT Key、模型广场里的模型 ID。
方式二：手动写配置文件
在 ~/.hermes/config.yaml 的 model 部分写入第一个标签的内容，把 Key 写进 ~/.hermes/.env（第二个标签）。这样 Key 不会出现在主配置文件里。
~/.hermes/config.yaml · 配置示例
model:
provider: custom
base_url: https://api.aiput.top/v1
default: MODEL_ID_FROM_CATALOG
key_env: AIPUT_API_KEY~/.hermes/.env · 存放 Key
AIPUT_API_KEY=YOUR_API_KEY各项的含义：
provider: custom：使用自定义端点。base_url：AIPUT 的地址，带/v1。default：默认使用的模型 ID。key_env：存放 Key 的环境变量名。
怎样确认配置成功
启动 Hermes Agent，发一句简短的问题，能收到回复就说明配置成功。
常见问题
| 现象 | 处理 |
|---|---|
| 启动时提示上下文太小 | 换一个上下文更长的模型，或按官方说明设置 context_length |
401 | 确认 ~/.hermes/.env 里的变量名和 key_env 一致 |
404 | base_url 只写到 /v1，不要多写路径 |
| 提示无法解析返回内容 | base_url 少写了 /v1 |
| "无可用渠道" | 账户还没有实名认证、模型 ID 写错，或模型当前不可用，见常见问题 |
本页按 2026 年 10 月的 Hermes Agent 版本编写，界面和配置项可能随版本变化，以 Hermes Agent 官方说明为准。Hermes Agent 的名称和商标归其所有者所有，这里只表示兼容。