WorkBuddy 接入 Nix API 第三方模型教程

这篇教程会带你在腾讯 WorkBuddy 中接入 Nix API 提供的第三方 AI 模型。配置完成后，就可以在 WorkBuddy 里通过 Nix API 调用 GPT、Claude、Gemini、DeepSeek 等模型。

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

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

注意：在 WorkBuddy 里配置时，一般填写的是 API Base URL：

https://nixapi.com/v1

不要填写完整的：

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

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

为什么要接入 Nix API

WorkBuddy 自带模型通常会消耗平台积分。如果你已经有 Nix API 的额度，或者希望统一使用自己的第三方 API Key，就可以把 Nix API 接入到 WorkBuddy 中。

接入后有几个好处：

可以使用 Nix API 支持的多个主流模型。

可以统一走自己的 API Key 和额度。

可以按实际调用量使用模型。

不必完全依赖 WorkBuddy 默认模型。

多个工具可以共用同一套第三方 API 服务。

前置准备

开始之前，你需要准备：

一个 Nix API 账号。

一个可用的 Nix API Key。

账户中有可用余额或额度。

确认你要使用的模型名称。

模型名称需要以 Nix API 后台实际展示为准，例如可能是：

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

不同平台支持的模型名称可能不同，配置时一定要复制完整名称，不要自己简写。

第一步：获取 Nix API Key

打开 Nix API 官网：

https://nixapi.com

登录账号后，进入控制台，找到 API Key 管理页面，创建一个新的 API Key。

创建后复制保存好，格式一般类似：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

注意：

API Key 只会完整显示一次，建议立即保存。

不要把 API Key 发给别人。

不要把 API Key 写进公开仓库。

如果怀疑泄露，应立即删除旧 Key，重新创建新 Key。

第二步：打开 WorkBuddy 模型配置

打开 WorkBuddy 客户端，找到左下角的设置入口。

一般路径是：

设置 → 模型设置

进入模型设置页面后，往下找到自定义模型配置入口，通常是：

+ 配置自定义模型

或者类似名称：

添加自定义模型
Custom Model
自定义 Provider

不同版本的 WorkBuddy 菜单名称可能略有差异，但核心就是进入“自定义模型”或“模型设置”页面。

第三步：填写 Nix API 配置信息

在自定义模型配置窗口中，按下面填写：

配置项	填写内容
提供商	自定义 / Custom / OpenAI Compatible
API 端点	`https://nixapi.com/v1`
API Key	你的 Nix API Key
模型名称	你要使用的模型名称

示例：

提供商：自定义 / Custom
API 端点：https://nixapi.com/v1
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx
模型名称：gpt-4o

这里最重要的是 API 端点。

正确写法：

https://nixapi.com/v1

错误写法：

https://nixapi.com

错误写法：

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

因为 WorkBuddy 会根据 OpenAI 兼容接口自动请求 /chat/completions，所以这里不要把完整聊天接口填进去。

第四步：保存并启用模型

配置完成后，点击：

确定
保存
添加

保存后回到模型列表，找到刚才添加的自定义模型。

这里有一个很容易漏掉的步骤：需要手动勾选或启用这个模型。

如果没有勾选启用，WorkBuddy 可能仍然会使用默认模型，而不是你配置的 Nix API 模型。

确认模型状态为：

已启用
已勾选
可用

第五步：测试模型是否可用

打开 WorkBuddy 的任意对话窗口，选择刚刚配置的模型，然后发送一句简单测试：

你好，请用一句话介绍一下你自己。

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

也可以测试一个更具体的问题：

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

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

第六步：配置多个模型

如果你想在 WorkBuddy 中配置多个模型，可以重复上面的步骤。

例如你可以分别添加：

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

每个模型都可以单独配置一次。

配置时 API 端点和 API Key 可以相同，只需要修改模型名称。

示例：

API 端点：https://nixapi.com/v1
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx
模型名称：deepseek-chat

再添加一个：

API 端点：https://nixapi.com/v1
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx
模型名称：gpt-4o-mini

之后在 WorkBuddy 对话窗口中切换对应模型即可。

第七步：用 curl 验证 Nix API 是否正常

如果 WorkBuddy 配置后调用失败，可以先用 curl 测试 Nix API 本身是否正常。

打开终端执行：

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

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

如果 curl 能正常返回模型回复，说明 Nix API 本身没有问题，问题大概率在 WorkBuddy 配置项上。

如果 curl 也失败，需要优先检查 Nix API 账户、Key、余额、模型名称或网络访问。

常见问题

1. 配置完还是在用 WorkBuddy 默认模型？

检查模型列表里是否勾选了刚才配置的自定义模型。

如果没有启用，WorkBuddy 可能仍然使用默认模型。

处理方式：

打开 WorkBuddy 设置。

进入模型设置。

找到自定义模型。

勾选启用。

在对话窗口中手动切换到该模型。

2. 提示 API Key 无效

通常是 API Key 填错了。

重点检查：

API Key 是否复制完整
API Key 前后是否有空格
API Key 是否已经被删除
账户是否还有余额
Key 是否有模型调用权限

建议重新创建一个新的 Nix API Key，再复制到 WorkBuddy 中测试。

3. 提示模型不存在

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

例如你填写了：

deepseek

但实际模型名称可能是：

deepseek-chat

又比如你填写了：

claude-sonnet

但实际模型名称可能是：

claude-sonnet-4-20250514

解决办法：

查看模型列表。

复制完整模型名称。

回到 WorkBuddy 重新配置。

4. 提示请求失败

优先检查 API 端点是否填写正确。

正确：

https://nixapi.com/v1

错误：

https://nixapi.com

错误：

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

如果地址没问题，再检查：

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

Nix API 账户是否有余额。

模型名称是否正确。

WorkBuddy 是否支持 OpenAI Compatible 自定义模型。

是否启用了刚添加的模型。

5. 能不能同时配置多个模型？

可以。

你可以重复添加多个自定义模型，每次填写不同的模型名称。

例如：

模型 1：gpt-4o
模型 2：gpt-4o-mini
模型 3：deepseek-chat
模型 4：claude-sonnet-4-20250514

API 端点都可以使用：

https://nixapi.com/v1

API Key 也可以使用同一个 Nix API Key。

6. WorkBuddy 是否一定支持 Nix API？

只要 WorkBuddy 的自定义模型支持 OpenAI Compatible 接口，并且 Nix API 兼容 OpenAI 的 /v1/chat/completions 格式，就可以接入。

如果你的 WorkBuddy 版本没有自定义模型入口，可能需要：

更新 WorkBuddy 到新版本。

检查是否需要开启高级设置。

确认当前账号是否有自定义模型权限。

最终配置总结

WorkBuddy 接入 Nix API 时，最关键的是这几项：

提供商：自定义 / Custom / OpenAI Compatible
API 端点：https://nixapi.com/v1
API Key：sk-your-nixapi-key
模型名称：gpt-4o

最容易填错的是 API 端点。

一定要填：

https://nixapi.com/v1

不要填：

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

配置完成后，记得在 WorkBuddy 模型列表中启用该模型，并在对话窗口中切换使用。

WorkBuddy 接入 NixAPI 模型教程

WorkBuddy 接入 Nix API 第三方模型教程#

为什么要接入 Nix API#

前置准备#

第一步：获取 Nix API Key#

第二步：打开 WorkBuddy 模型配置#

第三步：填写 Nix API 配置信息#

第四步：保存并启用模型#

第五步：测试模型是否可用#

第六步：配置多个模型#

第七步：用 curl 验证 Nix API 是否正常#

常见问题#

1. 配置完还是在用 WorkBuddy 默认模型？#

2. 提示 API Key 无效#

3. 提示模型不存在#

4. 提示请求失败#

5. 能不能同时配置多个模型？#

6. WorkBuddy 是否一定支持 Nix API？#

最终配置总结#