很多人第一次打开 WorkBuddy，马上就会碰到两个问题：

自带的模型不够用怎么办？手里已经有其他平台的 API，能不能直接接进来？

答案是可以。只要模型服务支持 OpenAI 兼容接口，通常准备好接口地址、API Key 和模型名称，就能完成配置。

听起来有点技术，真正要填的内容其实不多。下面我们从零开始操作。建议先收藏，万一遇到报错，回来对照检查会省不少时间。

WorkBuddy 会持续更新，不同版本中的按钮名称和位置可能略有差别。请以当前客户端显示的界面为准，需要填写的核心参数基本一致。

一、为什么要接入自定义模型

不同模型各有所长。有的适合写作，有的擅长代码，有的响应快，有的长文本能力更好。接入自定义模型后，可以按任务选择合适的模型，也能继续使用已经购买的 API 额度。

自定义 API 的费用由对应服务商收取。配置前先看清计费规则，后面也要在服务商后台关注余额和用量。

二、配置前准备三项信息

1. 接口地址

接口地址也可能叫 API URL、Endpoint、Base URL 或请求地址。常见形式如下：

https://www.cbapi.ai/v1/chat/completions

有些平台只提供到 /v1 的基础地址。到底填哪一种，请同时看 WorkBuddy 输入框提示和服务商文档。不要凭感觉删路径，这是 404 报错的高发原因。

2. API Key

API Key 相当于服务的访问密码，常见格式类似 sk-xxxxxxxx。复制时别带空格或引号，更不要把真实 Key 发到群里或放进公开截图。

3. 模型名称或模型 ID

模型 ID 必须和服务商后台逐字一致。大小写、横线和版本后缀都可能影响调用，最稳妥的办法是直接复制。

三、打开 WorkBuddy 模型配置

打开 WorkBuddy 桌面端，进入模型相关设置。入口可能位于新建任务页面的模型选择区、模型下拉列表中的“配置自定义模型”，或设置页面中的“模型管理”。

如果需要选择服务商，优先找“自定义”“OpenAI Compatible”或“OpenAI 兼容”。看到其中任意一个，通常就找对了。

四、逐项填写模型参数

服务名称

用于自己识别，可以写成“cbapi 日常写作”或“公司通用模型”。显示名称可以自定义，但不能用它替代真实模型 ID。

接口地址

完整粘贴服务商提供的地址，检查开头协议、空格，以及路径是否需要包含 /v1 或 /chat/completions。

API Key

粘贴真实密钥。输入框用圆点或星号隐藏内容是正常现象，不要通过截图找别人帮你检查。

模型 ID

从服务商的模型列表复制准确名称，不要根据宣传名自行猜测。

五、cbapi.ai 脱敏示例

登录 cbapi.ai 后台，在控制台或接入文档中确认三项信息：

接口地址：以控制台当前提供的地址为准 API Key：sk-xxxxxxxxxxxxxxxx 模型名称：以控制台实际 Model ID 为准

本文不写死接口地址和模型 ID，因为第三方平台可能调整域名、线路或可用模型。直接复制自己控制台里的最新信息，比照抄旧教程可靠。

六、用一句话验证连接

保存后回到新建任务或新建对话页面，选中刚添加的模型，先发送：

请只回复“连接成功”，不要补充其他内容。

能正常回复，说明基础调用已经打通。再测试一条短写作任务，确认生成能力稳定。先别急着读大文件或跑复杂任务，简单测试更容易排错。

七、常见报错怎么处理

401 或 Unauthorized

检查 API Key 是否完整，前后有没有空格或引号，密钥是否过期、被禁用，或来自另一个平台。

404 或 Not Found

重点检查接口路径。确认是否缺少或多写了 /v1、/chat/completions。

429 或 Too Many Requests

检查余额、每分钟请求限制、并发任务数量，以及当前线路是否繁忙。

提示模型不存在

重新从服务商后台复制模型 ID，并确认当前 Key 有调用权限。

一直转圈或超时

先用简单问题重试，再检查网络和服务商状态。简单问题成功、复杂任务超时，通常和上下文长度、文件大小或模型速度有关。

八、密钥和费用安全

在服务商后台设置消费提醒或额度上限。团队使用时，尽量按成员或设备创建不同的 Key，别让所有人长期共用一把钥匙。

如果密钥出现在截图、群聊或公开文档中，立即撤销并重新生成。只删除消息不够，因为它可能已经被复制。

配置模型只要几分钟，密钥安全却不能只管几分钟。这一步真别省。

阅读原文：点击这里​