WorkBuddy 三方 Key 配置 — APIMaster.ai 自定义模型接入指南

WorkBuddy 是桌面端 AI Agent（支持工作区文件、技能指令与多模型切换）。APIMaster.ai 提供 OpenAI 兼容 接口，在 WorkBuddy 的 Custom Models 中添加自定义模型即可接入。

开始前请 获取 API Key。Key 仅保存在本机 %USERPROFILE%\.workbuddy\models.json，不要发到群聊或截图。

---

前置条件

1. 已安装并打开 WorkBuddy 桌面客户端。
2. 已从 APIMaster 控制台 复制 API Key。
3. 已在 模型广场 选好目标 model id（如 gpt-5.6-sol、claude-sonnet-4-6、deepseek-v4-pro）。

---

第 1 步：打开自定义模型配置

任选一种入口：

方式 A（推荐） — 从对话模型选择器进入：

1. 在主界面底部输入框旁，点击当前模型名称（如 Auto 或已选模型）。
2. 在弹出菜单底部点击 Configure custom models（配置自定义模型）。

方式 B — 从设置页进入：

1. 打开 Settings（设置）。
2. 左侧选择 Models。
3. 在 CUSTOM MODELS 区域点击 + Add Model。

配置保存在本机：

• Windows：%USERPROFILE%\.workbuddy\models.json
• macOS / Linux：~/.workbuddy/models.json

---

第 2 步：填写 APIMaster 连接信息

在 Add Model 对话框中填写（界面提示 OpenAI-compatible API required）：

字段	填写内容
Provider	Custom
Endpoint	https://apimaster.ai/v1（必须带 /v1）
API Key	粘贴你的 APIMaster Key
Model Name	与 模型广场 一致的 model id，如 gpt-5.6-sol、claude-sonnet-4-6

Advanced Settings（高级设置）建议：

选项	建议
Tool Calling	✅ 勾选（Agent 调用工具 / 技能需要）
Image Input	✅ 勾选（若模型支持多模态）
Reasoning	按模型能力决定；多数聊天模型可保持不勾选
Custom Protocol	❌ 不勾选（使用标准 OpenAI 兼容协议）

Input / Output 可保持 Use provider default，或按模型上下文窗口点选预设（如 Input 128K、Output 16K）。

填写完成后点击 Save。

说明：

• Model Name 须与 APIMaster 上架 id 完全一致（大小写、连字符不能错）。
• 换模型时再 + Add Model 添加一条即可，Endpoint 与 Key 可复用同一套。
• 保存后模型会出现在 SAVED MODELS，并进入对话选择器的 Custom Models 分组。

---

第 3 步：在对话中选用自定义模型

1. 回到主界面，打开模型选择器。
2. 在 Custom Models 分组中选中刚添加的模型（如 gpt-5.6-sol）。
3. 发送测试消息（如 hi）。
4. 回复气泡旁应显示对应模型名，表示已通过 APIMaster 出站。

---

常用 Model ID 参考

以下 id 与 APIMaster GET /v1/models 一致（以账户实际开通为准）：

model id	说明
gpt-5.6-sol	GPT 系列示例（截图所用）
gpt-5.4 / gpt-5.5	GPT 系列
claude-sonnet-4-6	Claude Sonnet，均衡
claude-opus-4-8	Claude Opus，更强推理
deepseek-v4-pro / deepseek-v4-flash	DeepSeek 系列
minimax-m3 / kimi-k3	其他常用模型

请从 模型广场 复制最新 id，不要手打或猜别名。

---

常见问题

现象	处理
401 / Unauthorized	检查 API Key 是否完整；在 Add Model 中重新粘贴并 Save
404 / model not found	Model Name 与广场 id 不一致；重新复制粘贴
连接失败 / 超时	确认 Endpoint 为 https://apimaster.ai/v1（勿漏 /v1）；检查网络与代理
Custom Models 列表为空	确认已点 Save；重启 WorkBuddy 后刷新模型选择器
Agent 工具调用失败	在 Advanced Settings 勾选 Tool Calling 后重新保存
找不到配置入口	模型选择器底部 Configure custom models，或 Settings → Models → + Add Model

---

核对清单

• 已安装 WorkBuddy
• Provider = Custom
• Endpoint = https://apimaster.ai/v1
• Model Name 来自 模型广场
• 已勾选 Tool Calling（如需 Agent 工具）并点 Save
• 对话选择器 Custom Models 中可选中该模型且能正常回复

---

相关链接

• Agent 配置教程总览
• Cline · Cursor · Kilo Code
• OpenAI 兼容接入 · 获取 API Key