短聊天与模型切换
复现：用 hermes model 添加 Custom endpoint，重启会话后询问当前配置并发送短问题。
通过：实际 provider、模型和日志都指向新端点；/model 后再次确认。
正在打开页面…
正在加载内容，请稍候。
Hermes Agent Custom endpoint：模型切换与运行环境
Hermes Agent Custom endpoint 通过 hermes model 配置匹配的 API base URL、Key 和准确模型 ID，再检查 model.provider、model.default 与 model.base_url 对应同一服务。新会话先测短文本，再验收测试文件的工具任务。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
退出 Hermes 会话，在终端执行 hermes model，选择 Custom endpoint，填 https://api.apizt.com/v1、apizt Key 和授权模型 ID。会话内 /model 切换已配置模型，不等于新增提供商。
适合用 Hermes Agent 的终端会话、长期任务和工具。默认聊天能回答之后，还要验证工具权限、上下文限制与进程加载的模型。
按真实任务判断是否可用
受控文件任务
复现：让 Hermes 在测试目录读取 README，并概括两行。
通过：有真实文件读取事件，回答包含文件内容；仅文字模型回复不算工具通过。
先选对协议和请求地址
Hermes 的 custom provider 使用 OpenAI 兼容 base_url；~/.hermes/config.yaml 的 model.provider、model.default 和 model.base_url 必须一致。CLI、守护进程可能读取不同环境。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
hermes model → Custom endpoint
API base URL：https://api.apizt.com/v1
API Key：apizt 令牌
模型 ID：控制台授权值
~/.hermes/config.yaml：
model:
provider: custom
default: MODEL_ID_FROM_CONSOLE
base_url: https://api.apizt.com/v1这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 Hermes Agent Custom endpoint 配置与验证清单照这个顺序接入
- 01
添加提供商
从当前会话退出，在终端执行 hermes model，选择 Custom endpoint 并填写模型、Key 与 URL。
- 02
核对持久配置
查看 config.yaml 和 .env 的实际生效项，修改 model 节点时不要覆盖其他配置；重新启动运行进程。
- 03
按任务验证
先短聊天，再测试读文件。遇到长上下文失败时查看检测到的 context_length 与真实模型能力。
对照工具配置与验证顺序
验证到哪一步？
Hermes 官方 FAQ 明确 hermes model、Custom endpoint、/model 和 config.yaml 的关系。
- 现有依据
- 官方 Custom endpoint 流程已核对
- 验证边界
- 没有 Hermes 代理带密钥付费调用或工具执行记录。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
Hermes Agent 多轮执行会反复携带上下文并产生工具前后请求；以整个任务用量、重试与平台实扣统计，不按第一轮价格推断。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| /model 看不到新提供商 | 会话内切换器只展示已配置项，尚未通过 hermes model 添加。 | 退出会话运行完整配置向导，再开新会话。 |
| Key 无效或仍走旧模型 | provider、base_url、默认模型或 .env 来源冲突。 | 检查 hermes config show 与 hermes logs 的脱敏输出。 |
| 短问答成功，长任务中断 | 上下文限制、工具能力或自动压缩行为未核验。 | 先缩短测试任务，再检查实际 context_length 和第一条错误。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
新会话先发短消息，再授权读取测试文件。若仍失败，查看本机 hermes logs，分享前删除密钥、私有提示词和敏感路径。
查看 Hermes Agent 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
Hermes Agent Custom endpoint 设置后仍访问旧服务怎么办？
退出旧会话，核对 hermes model 的提供商配置与 ~/.hermes/config.yaml、.env，保留其他设置。确认运行进程读取的 provider、模型和地址，守护进程与终端环境可能不同。
Hermes 的 /model 和 hermes model 有什么区别？
会话内 /model 切换当前选择，终端 hermes model 用于提供商配置。切换名称不一定新增或修复 Custom endpoint；保存后新开会话并核对实际请求。
Hermes Agent 应该填写哪个 API 地址？
运行 hermes model 配置 Custom endpoint，API base URL 为 https://api.apizt.com/v1；模型、provider 与 URL 应作为同一组设置。
终端请求成功，为什么客户端仍然失败？
CLI、守护进程或其他运行环境可能读取不同环境变量；终端成功时仍需核对实际运行进程。 短文本成功但 Agent 出错时，检查工具协议及上下文限制；上下文长度应按真实模型能力设置。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。
2026 年 11 月 5 日补测
Hermes 自定义 Provider 失败：确认实际读取的文件
检查真实 config path，再修正样例端点与默认模型的对应关系。
- Hermes Agent 0.18.0 原生 CLI（隔离配置）。
- 准备独立样例。安装文章所用客户端，或用 Python 3.11+ 运行标注为本地 HTTP/TOML 的样例。
- 本例操作：检查真实 config path，再修正样例端点与默认模型的对应关系。
- 解压练习包，执行 python3 lab.py --output ./result u12。完整命令、样例输入和输出保存在回执。
- 打开 result/u12.json，对照实际退出码、请求路径或产物字段。
- 逐项确认下方通过条件。本例的测试范围以运行回执为准。
- 通过：当前 CLI 只读取目标目录模型
- 通过：两份配置路径没有混用
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。