# WorkBuddy

自定义 API · Chat Completions

## 添加自定义模型

1. 打开 WorkBuddy「设置 → 模型」，添加模型。
2. 选择 Custom，填写下面的值。将 `<YOUR_FOXMU_API_KEY>` 替换为完整密钥，`<MODEL_ID>` 替换为准确的模型 ID。
3. 按模型实际能力设置工具调用、图片和推理等选项。厂商预设可能自动填写这些标记，自定义模型仍需正确配置。

```text
Provider: Custom
URL: https://foxmu.ai/v1
API Key: <YOUR_FOXMU_API_KEY>
Model: <MODEL_ID>
Custom Protocol: Off
```

## 保存并选择模型

点击 Save，在聊天模型选择器的自定义模型分组中选择新模型，发送简短消息，并在[使用记录](/usage-logs)中查看结果。

| Custom Protocol | URL 行为 |
| --- | --- |
| 关闭 | 校验 URL 并补全标准 `/chat/completions` 路径 |
| 开启 | 直接使用完整 URL，不自动补全路径 |

上面的根地址加版本号写法保持关闭。若填写完整地址 `https://foxmu.ai/v1/chat/completions`，则开启该选项。

## 检查 WorkBuddy 接入设置

| 现象 | 检查项 |
| --- | --- |
| 401 | 完整应用密钥、环境与密钥状态 |
| 404 | URL 与 Custom Protocol 开关，避免重复路径 |
| 文本正常但工具失败 | 工具能力标记与模型实际支持 |
| 模型不符合预期 | 聊天中实际选择的模型，而不仅是已保存的配置 |

旧的 `~/.codebuddy/models.json` 配置仍可在模型设置中查看和编辑。混用文件和 UI 配置前，先核对已安装的 WorkBuddy 版本。

## 下一步

- [创建 API 密钥](https://foxmu.ai/keys)
- [打开在线调试](https://foxmu.ai/playground)
- [查看使用记录](https://foxmu.ai/usage-logs)
- [浏览文档目录](https://foxmu.ai/docs)

## 官方参考

- [WorkBuddy model settings](https://www.codebuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)