简介:本文教你在WorkBuddy中通过自定义模型接入DeepSeek、智谱等平价大模型,说明API Key、接口地址和模型名称的填写方法,给出接入前检查项与最小测试步骤,并梳理鉴权失败、地址错误、模型名错误和余额不足等常见报错的排查方法,帮你摆脱单一平台积分限制,按需切换模型。
在WorkBuddy中接入DeepSeek、智谱等第三方大模型,可以摆脱单一平台积分或套餐的限制,在同一个对话入口切换多个模型。这件事的核心是”自定义模型”:从模型服务商获取API Key、接口地址和模型名称,填入WorkBuddy即可。API是调用模型能力的接口。只要WorkBuddy支持自定义模型提供方,外部模型就能接入同一个入口。
模型名称、接口地址和菜单路径会随服务商和软件版本调整。操作前请以服务商官方文档和WorkBuddy当前界面为准。
配置前先确认以下五项。
| 检查项 | 说明 | 获取位置 |
|---|---|---|
| WorkBuddy是否支持自定义模型提供方 | 不支持时,后续配置入口不会出现 | 当前版本的设置页面或官方说明 |
| API Key | 验证调用者身份的密钥,多数以 sk- 开头 |
服务商控制台的API Keys页面 |
| 接口地址(Base URL) | 模型服务的请求入口 | 服务商官方API文档 |
| 模型名称 | 指定调用哪个模型 | 服务商文档或控制台的模型列表 |
| 账户额度 | 确认余额、Token包或套餐可用 | 服务商控制台的账单或套餐页面 |
API Key通常只在创建时完整显示一次。关闭页面后若找不到,只能删除旧密钥并重新创建。创建后立即保存到密码管理器,不要粘贴到聊天记录、截图或代码仓库中。
以DeepSeek、智谱等平台为例,流程大体相同:
建议为每个工具单独创建一把密钥。一旦某把密钥泄露,只需删除它,其他服务不受影响。若平台支持,还可以为密钥设置消费上限。
不同服务商的接口地址格式不同。DeepSeek提供OpenAI兼容格式的接口,常见Base URL为 https://api.deepseek.com,部分调用方式需要在地址后加 /v1。智谱的接口路径规则与DeepSeek不同,需以其官方文档为准。
不要凭印象填写地址,也不要直接复制来路不明的博客地址。请以官方API文档中的Base URL为准,并确认它对应的接口协议(如OpenAI兼容格式)与WorkBuddy支持的格式一致。
按以下路径进入配置页面。这是常见路径,不同版本的菜单名称可能不同,请以你当前界面为准:
左下角头像 → 设置 → 模型 → 添加模型 → 自定义模型
依次填写:
deepseek-chat,具体以控制台的模型列表为准。保存后回到模型列表,确认新模型已出现,再在对话框中选择它。
不要直接用于长任务。先发送一句简单的话,例如”请用一句话介绍你自己”。若能正常返回内容,说明密钥、接口地址和模型名称基本无误。若失败,请看下一节。
接入失败时,先看报错现象,再按下表逐项检查。服务商返回的错误码和文字可能随版本变化,以官方错误码说明为准。
| 现象 | 常见原因 | 处理步骤 |
|---|---|---|
| 鉴权失败(401或403) | API Key错误、复制时带入空格,或密钥已被删除 | 重新复制密钥,检查首尾空格;在控制台确认该密钥仍然有效,无效则重新创建 |
| 接口地址错误(404) | Base URL多写或少写了 /v1,或使用了其他协议的地址 |
对照官方文档重新填写地址,确认接口协议与WorkBuddy一致 |
| 模型名称不存在 | 模型标识拼写错误,或该模型已下线或改名 | 复制控制台模型列表中的名称,不要手动拼写 |
| 限流(429) | 短时间内请求过多,超出并发或频率限制 | 等待片刻后重试,减少同时发起的请求 |
| 余额不足(常见为402) | 账户余额为零,或套餐额度已用完 | 在控制台账单页查看余额,充值或确认套餐有效期 |
排查顺序建议为:先确认余额,再确认密钥,然后检查地址,最后核对模型名称。这样能避免反复修改无关字段。
部分平台提供Coding Plan或Token Plan等套餐。Coding Plan一般面向代码生成、代码解释和调试场景,通常以套餐形式提供相对优惠的调用额度。Token Plan则更偏向Token资源包,在一定额度或有效期内调用指定模型。
两类套餐的规则差异较大,开通前请逐项确认:
| 确认项 | 需要问清的问题 |
|---|---|
| 套餐类型 | 属于Coding Plan还是Token Plan,适用场景是什么 |
| 包含模型 | 套餐覆盖哪些模型,是否包含你要用的模型 |
| 调用方式 | 是否允许通过API调用,是否允许在第三方工具中使用 |
| 接口兼容 | 接口格式是否与WorkBuddy兼容 |
| 额度与超额 | 额度消耗规则是什么,超额后是停用还是按量计费 |
| 有效期与限购 | 有效期多久,是否限购,是否可以续费 |
| 退款规则 | 开通后能否退款,退款条件是什么 |
如果上述任何一项无法在官网找到明确说明,建议先小额测试,或咨询服务商客服,再决定是否长期使用。套餐条款可能调整,以购买时页面展示的内容为准。