文档客户端配置配置 WorkBuddy
配置 WorkBuddy
使用 OpenAI Chat Completions 兼容接口将 WorkBuddy 接入 SoleAPI。
配置 WorkBuddy
WorkBuddy 当前处于兼容性测试阶段。本页记录目前已经验证的配置方式和模型范围，测试结果可能随着 WorkBuddy 或上游模型服务更新而变化。
当前仅验证通过 OpenAI Chat Completions 兼容接口：/v1/chat/completions。目前已测试成功的供应商为 xAI（Grok） 和 OpenAI（GPT）；GLM、Qwen、DeepSeek、MiniMax 当前测试未通过，暂不能保证可用。
打开添加模型表单
请在 WorkBuddy 中进入添加模型的表单。不同版本的菜单名称可能略有不同，请以当前客户端界面为准。
填写模型配置
-
供应商：选择【自定义】。
-
接口地址：填写
https://soleapi.com/v1/chat/completions。 -
API Key: 填写在 SoleAPI 控制台创建的 API Key。
-
模型名称：前往模型广场复制模型id。
-
高级配置：必选【自定义协议】，其余按照模型能力选择是否开启。
测试并保存
填写完毕后点击【测试连接】按钮，查看是否返回正常结果，提示成功后点击【保存】即可。回到对话框右下角即可选择刚添加的模型。
当前测试结果
| 供应商 | 当前结果 | 备注 |
|---|---|---|
| xAI（Grok） | √ | 使用 /v1/chat/completions |
| OpenAI（GPT） | √ | 使用 /v1/chat/completions |
| GLM | × | 等待接入Completions兼容协议 |
| Qwen | × | 等待接入Completions兼容协议 |
| DeepSeek | × | 等待接入Completions兼容协议 |
| MiniMax | × | 等待接入Completions兼容协议 |
“当前失败”仅表示目前的 WorkBuddy 兼容调用测试未通过，不代表这些供应商在 SoleAPI 的其他协议或客户端中不可用。请不要据此推断所有国产模型都不支持；后续测试结果会继续更新。
常见问题
- 请求返回 404 或提示接口不存在：确认接口地址是
https://soleapi.com/v1/chat/completions。 - 请求返回 401：检查 API Key 是否完整、是否已停用或过期。
- 请求返回 403：检查 API Key 是否包含调用的模型分组，若启用了白名单，请确保您的设备IP在白名单中。
- 模型不存在或无法调用：检查模型名称是否为该 API Key 实际可用的模型 ID，并确认调度分组权限。
- 已勾选自定义协议仍然失败：先使用已验证成功的 Grok 或 GPT 模型复测，以区分 WorkBuddy 配置问题和具体模型兼容性问题。