WorkBuddy 接入第三方 API 快速教程：自定义模型配置方法

在 WorkBuddy 中添加第三方自定义模型，使用 OpenAI 兼容接口调用 GPT、Claude、Gemini、DeepSeek 等模型，并避免继续消耗默认积分。

WorkBuddy 支持添加自定义模型服务。把它接到 NixAPI 后，你可以用一组 OpenAI 兼容配置调用不同模型，并按实际用量计费，不必只依赖 WorkBuddy 内置模型积分。

这篇教程只覆盖必要步骤：获取 Key，新增自定义模型，启用模型并完成一次对话测试。

为什么在 WorkBuddy 里配置 NixAPI

WorkBuddy 自带模型适合开箱即用，但如果你希望更灵活地选择模型，或者想统一管理多款工具的 API 用量，自定义接入会更方便。

接入 NixAPI 后，你可以：

用同一个 API Key 调用 GPT、Claude、Gemini、DeepSeek 等模型
根据任务选择不同模型，而不是固定使用内置模型
在 NixAPI 模型价格页查看模型价格后再决定使用哪一个
通过 NixAPI 控制台管理 Key 和余额

NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。如果你经常在 WorkBuddy 中处理长文本或代码任务，可以先估算一下使用成本。

第一步：创建 NixAPI API Key

打开 NixAPI 首页，注册并登录账号。进入控制台后创建一个新的 API Key，建议命名为 workbuddy，方便后续区分来源。

创建后立即复制保存。API Key 通常只完整显示一次，不建议放进公开文档、截图或 Git 仓库。

后面示例里用占位符表示：

nix-your-api-key

请替换为你的真实 Key。

第二步：打开 WorkBuddy 模型设置

启动 WorkBuddy，进入设置面板。通常可以从左下角的设置图标进入，然后选择「模型设置」或类似的模型管理页面。

在模型设置页面滚动到底部，找到「配置自定义模型」「添加自定义模型」或 Custom Model 入口。

不同版本的 WorkBuddy 文案可能略有差异，只要是能填写自定义 API 端点和 Key 的入口即可。

第三步：填写自定义模型信息

在弹出的自定义模型窗口中，按下面填写：

字段	填写内容
提供商	`Custom` / `自定义`
API 端点	`https://nixapi.com/v1`
API Key	`nix-your-api-key`
模型名称	例如 `claude-sonnet-4-20250514`

可先测试这些模型 ID：

claude-sonnet-4-20250514
gpt-5.4
gemini-3-pro-preview
deepseek-v4
minimax-m3

模型名称需要和 NixAPI 当前支持的 ID 完全一致。如果不确定，打开 NixAPI 支持的模型列表页复制即可。

填写完成后点击保存。

第四步：启用刚添加的模型

保存自定义模型后，回到 WorkBuddy 的模型列表，找到刚才添加的模型并勾选启用。

这一步很容易漏。如果只保存但没有启用，WorkBuddy 可能仍然使用默认模型或内置积分通道。启用后再回到对话窗口，选择你刚配置的模型。

第五步：发送测试消息

在 WorkBuddy 中发一条简单测试消息：

请用三条要点总结今天的工作计划。

如果能正常返回内容，说明配置已经生效。

如果没有响应，可以先把同一个 Key 和模型放到 curl 里验证：

curl https://nixapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nix-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl 正常而 WorkBuddy 不正常，问题多半在 WorkBuddy 的启用状态或字段填写；curl 也失败，则优先检查 Key、模型名和账户状态。

常见问题

1. 配好后仍然消耗 WorkBuddy 积分

检查模型列表里是否勾选了自定义模型。只创建配置不等于启用配置。

2. 提示 API Key 无效

确认复制的是 NixAPI 的 Key，并且前后没有空格。必要时到 NixAPI 控制台重新创建一个 Key。

3. 提示模型不存在

模型名拼写不准确。建议从 NixAPI 支持的模型列表页复制模型 ID，不要手动猜。

4. 能不能添加多个模型？

可以。重复添加自定义模型，每次换不同的模型名称即可。常用做法是分别配置一个高质量模型和一个低成本模型，在不同任务里切换。

小结

WorkBuddy 接入 NixAPI 的关键只有三项：https://nixapi.com/v1、有效 API Key、准确模型 ID。配置完成并启用后，WorkBuddy 就可以通过 NixAPI 调用多种模型。后续要换模型时，只需要新增或修改模型名称，不必更换整套接入方式。

WorkBuddy 接入第三方 API 快速教程：配置自定义模型接口