Hermes Agent 接入 Nix API 模型教程

这篇教程会带你从零开始，把 Hermes Agent 接入 Nix API 提供的第三方 AI 模型。只要 Nix API 兼容 OpenAI 接口格式，Hermes 就可以像调用 OpenAI 一样调用它。

本文使用的接口地址如下：

官网地址：https://nixapi.com
API Base URL：https://nixapi.com/v1
聊天接口：https://nixapi.com/v1/chat/completions

注意：在 Hermes 里配置时，一般填写的是 Base URL，也就是：

https://nixapi.com/v1

不要填写完整的：

https://nixapi.com/v1/chat/completions

否则可能会出现 404、接口路径重复、请求失败等问题。

前置准备

开始之前，你需要准备：

一台电脑，macOS、Linux、Windows 都可以。

一个 Nix API 的 API Key。

确认你的 Nix API 账户中有可用额度。

确认你要使用的模型名称，例如：

gpt-4o
gpt-4o-mini
claude-sonnet-4-20250514
deepseek-chat
gemini-2.5-pro

实际模型名称以 Nix API 后台展示为准。模型名称需要完全一致，大小写、横杠、版本号都不要写错。

第一步：安装 Hermes Agent

macOS / Linux / WSL2

打开终端，执行：

安装完成后，重新加载 shell 配置：

如果你使用的是 zsh，则执行：

Windows 用户

建议使用 WSL2 安装 Hermes。进入 WSL2 终端后，同样执行：

安装完成后执行：

第二步：配置 Nix API 作为模型供应商

Hermes 支持 OpenAI Compatible 类型的接口。Nix API 的调用方式如果兼容 OpenAI 的 /v1/chat/completions 格式，就可以直接接入。

在终端执行：

进入模型配置向导后，选择类似下面的选项：

OpenAI Compatible
Custom Provider
Custom Endpoint

不同版本的 Hermes 菜单名称可能略有差异，核心就是选择“OpenAI 兼容接口”或“自定义 API Endpoint”。

然后按下面的信息填写：

配置项	填写内容
Provider 类型	OpenAI Compatible / Custom OpenAI Provider
API Key	你的 Nix API Key
Base URL	`https://nixapi.com/v1`
Model	你要使用的模型名称

示例：

API Key: sk-xxxxxxxxxxxxxxxx
Base URL: https://nixapi.com/v1
Model: gpt-4o

这里最容易填错的是 Base URL。

正确：

https://nixapi.com/v1

错误：

https://nixapi.com

错误：

https://nixapi.com/v1/chat/completions

Hermes 会自己拼接 /chat/completions 这类请求路径，所以 Base URL 只需要填到 /v1。

第三步：手动修改配置文件

如果配置向导中没有 Base URL 选项，或者你想直接手动改配置，可以编辑 Hermes 配置文件。

macOS / Linux / WSL2：

Windows WSL2 下同样是：

可以参考下面的配置：

把 sk-your-nixapi-key 替换成你自己的 Nix API Key。

把 gpt-4o 替换成你实际要用的模型名称。

如果你的 Hermes 版本使用的是更细分的 provider 配置，也可以按下面这种思路配置：

不同版本的 Hermes 配置结构可能不完全一样。如果你不确定，以 hermes model 自动生成的配置为准，然后只修改 api_key、base_url、model 这几个字段。

第四步：启动 Hermes 测试

配置完成后，在终端执行：

进入 Hermes 对话界面后，发送一句简单的问题：

你好，简单介绍一下你自己。

如果模型正常返回内容，说明 Hermes 已经成功通过 Nix API 调用了第三方模型。

你也可以测试一个更明确的问题：

请用三句话解释一下什么是 Spring Cloud。

如果能够正常回答，说明基础配置已经跑通。

第五步：切换模型

如果你想换模型，可以重新执行：

然后选择新的模型名称。

也可以在 Hermes 对话界面里尝试使用：

/model

如果 Hermes 支持在当前版本中通过 /model 切换模型，就可以直接在对话中修改。

还可以手动修改配置文件中的模型字段：

改完后重新启动 Hermes：

第六步：用 curl 先验证 Nix API 是否可用

如果 Hermes 配置后仍然失败，建议先用 curl 测试 Nix API 本身是否能正常调用。

执行：

如果这个命令能正常返回模型回复，说明 Nix API 本身可用。

如果 curl 都失败，优先检查：

API Key 是否正确。

账户是否有余额。

模型名称是否存在。

Base URL 是否写对。

当前网络是否能访问 nixapi.com。

常见问题

1. 报错 401 Unauthorized

一般是 API Key 有问题。

重点检查：

API Key 是否复制完整
API Key 前后是否有空格
账户是否有余额
Key 是否被禁用

2. 报错 404 Not Found

大概率是 Base URL 填错了。

正确写法：

https://nixapi.com/v1

不要写成：

https://nixapi.com/v1/chat/completions

也不要只写：

https://nixapi.com

3. 报错 model not found

说明模型名称不正确，或者当前 Nix API Key 没有权限调用该模型。

解决办法：

找到模型列表。

复制完整模型名称。

回到 Hermes 重新配置。

例如模型名可能是：

deepseek-chat

而不是：

deepseek

也可能是：

claude-sonnet-4-20250514

而不是：

claude-sonnet

具体以 Nix API 后台为准。

4. Hermes 启动后没有使用我配置的模型

可以重新执行：

然后重新选择 provider、Base URL 和模型。

也可以打开配置文件检查当前配置：

重点看这几项：

5. 请求超时或连接失败

可能是网络问题，也可能是 Nix API 当前服务异常。

可以先测试接口连通性：

如果这个接口也无法访问，说明 Hermes 本身可能没有问题，需要检查网络、代理、防火墙或 Nix API 服务状态。

最终配置总结

Hermes 接入 Nix API 时，最关键的是这三个配置：

其中 Base URL 一定是：

https://nixapi.com/v1

不是：

https://nixapi.com/v1/chat/completions

只要 Nix API 兼容 OpenAI 的 Chat Completions 接口，Hermes 就可以通过 OpenAI Compatible Provider 的方式直接调用它。

Hermes Agent 接入 NixAPI 模型教程

Hermes Agent 接入 Nix API 模型教程#

前置准备#

第一步：安装 Hermes Agent#

macOS / Linux / WSL2#

Windows 用户#

第二步：配置 Nix API 作为模型供应商#

第三步：手动修改配置文件#

第四步：启动 Hermes 测试#

第五步：切换模型#

第六步：用 curl 先验证 Nix API 是否可用#

常见问题#

1. 报错 401 Unauthorized#

2. 报错 404 Not Found#

3. 报错 model not found#

4. Hermes 启动后没有使用我配置的模型#

5. 请求超时或连接失败#

最终配置总结#