WorkBuddy

通过 WorkBuddy 的自定义模型功能，可以连接兼容 OpenAI 接口格式的服务。下面以 TokenHot 为例，说明如何完成一次配置并验证模型是否可用。

开始前确认

请提前准备好以下内容：

一个有效的 TokenHot API Key；

已安装的 WorkBuddy 客户端；

目标模型的准确 ID，以及对应的调用权限。

API Key 只应填写在客户端的配置页面中，不要放进公开截图、代码仓库或文章正文。

添加自定义模型

1. 找到 WorkBuddy 设置入口

打开 WorkBuddy，点击窗口左下角的头像，从菜单中进入 Settings（设置）。

2. 新建模型配置

进入设置后，在侧边栏选择 Models（模型），再点击页面右上方的 + Add Model（添加模型）。

3. 填写 TokenHot 接入参数

在弹出的模型表单中，按下表填写：

项目	建议填写
Provider（提供商）	`Custom / 自定义`
API Endpoint（接口地址）	`https://api.tokenhot.cn/v1/chat/completions`
API KEY	你的 TokenHot API Key
Model Name（模型名称）	目标模型 ID，例如 `gpt-5.6-luna`

接口采用 OpenAI 兼容格式，因此关键是保证 Endpoint 和模型 ID 填写准确。模型 ID 请以 TokenHot 当前可用模型列表为准。

根据使用场景，还可以开启相应的能力选项：

能力选项	什么时候开启
Tool Call	需要模型调用外部工具或执行函数时
Image Input	需要向模型发送图片时
Reasoning Mode	使用支持推理能力的模型时

确认信息无误后，点击 Save（保存）。

4. 检查保存结果

保存成功后，返回 Saved Models（已保存模型），确认新模型已经出现在列表中。

5. 选择模型进行测试

回到 WorkBuddy 主界面，打开底部的模型下拉菜单，在 Custom Models（自定义模型） 中选中刚添加的模型，然后发送一条简单消息进行测试。

如何选择模型

请直接使用 TokenHot 提供的模型 ID，不要自行修改大小写、斜杠或版本号。可以根据任务选择文本、编程、视觉或推理模型；若某一模型不可用，优先检查它是否有权限、是否支持当前功能，以及名称是否填写完整。

问题排查

模型已保存，但列表中找不到

先关闭并重新打开 WorkBuddy，再从底部模型选择器的 Custom Models（自定义模型） 分组中查看。

发送请求时报错

逐项核对：

Endpoint 是否填写为：

https://api.tokenhot.cn/v1/chat/completions

API Key 是否完整，前后是否误加了空格。

Model Name 是否与 TokenHot 的模型 ID 完全一致。

Tool Call、Image Input、Reasoning Mode 等选项是否与模型能力相符。

账户是否具备调用权限、余额和足够的速率额度。

一眼看懂配置

Provider:     Custom / 自定义
Endpoint:     https://api.tokenhot.cn/v1/chat/completions
API Key:      你的 TokenHot API Key
Model Name:   你的模型 ID

开始前确认#

添加自定义模型#

1. 找到 WorkBuddy 设置入口#

2. 新建模型配置#

3. 填写 TokenHot 接入参数#

4. 检查保存结果#

5. 选择模型进行测试#

如何选择模型#

问题排查#

模型已保存，但列表中找不到#

发送请求时报错#

一眼看懂配置#