WorkBuddy 自定义 API 教程：模型入口与完整请求路径
从 WorkBuddy 模型设置添加自定义服务，核对 URL、API Key、模型 ID 和自定义协议开关，说明路径自动补全、本地凭据、权限与持续调用费用。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
本文对应腾讯 WorkBuddy 桌面产品，不把 CodeBuddy CLI 的配置步骤直接套进来。2026 年 9 月 30 日已核对 WorkBuddy 模型页及腾讯云官方说明；核验的是配置入口和协议路径，没有真实 API 调用记录。
图中连线用于说明配置关系，不是接口测试结果。
从模型设置添加，不改项目文件
腾讯云文档给出入口“头像 → 设置 → 模型”。打开自定义模型管理，若服务不在预设列表中，选择 自定义/Custom，手工填写 URL、API Key 和模型名；保存后在对话模型选择器中选中它。
界面可以添加、编辑和删除模型。官方提到旧 ~/.codebuddy/models.json 配置仍有兼容性，但新接入应优先使用当前界面，不必按旧教程另写一份文件。
URL 是完整目标还是待补全地址
默认状态会校验并补全标准 /chat/completions 路径。高级设置中的“自定义协议”开关打开后，直接使用填入的 URL，跳过路径校验与补全。这个开关改变地址处理方式，不足以证明支持任意请求结构。
以下采用完整 Chat 路径说明填写关系。地址仅为占位，本站未提供对应真实接口、Key 创建或充值功能，实际接入须另行取得正式参数。
URL：https://80321.cn/v1/chat/completions
API Key：YOUR_API_KEY
模型名：YOUR_MODEL_ID
自定义协议：开启（仅在已确认完整目标地址时）若实际服务只给基础地址，先核对版本的补全规则；不要仅凭示例就打开高级开关，更不能把 Messages 地址配成 Chat 请求。
保存后检查选择器与能力声明
确认模型出现在自定义分组，并在新任务中明确选中该模型。标准供应商预设可能写入工具、图片和推理能力标记，但自定义服务不能靠品牌相似来判断能力。
先要求只返回一行文字，不给文件或浏览器权限。文字正常后，再在空白目录检查一次只读任务；图片和工具调用单独验证。没有能力证据时，不要把所有开关全打开。
失败时先确认路径和模型权限
把填写的 URL 与实际请求目标核对，特别留意默认补全和高级开关是否造成重复路径。检查模型 ID 的大小写、账号权限与第三方配额。若使用企业版，管理员禁用的模型会隐藏或置灰，应由管理员核对，不靠修改文件绕过。
只收集脱敏错误信息。尚未确认接口协议、请求目标或模型 ID 时停止调用，避免 Agent 在后台重复试错。
本地 Key 也要按秘密管理
官方说明配置含 Key 保存在本地 workbuddy/models.json，自定义模型费用由第三方收取，任务可能持续产生模型调用。
本地保存不代表可以公开备份。不要导出整份模型文件供别人排错；分享前移除 Key。首次使用限制目录和预算，检查第三方隐私规则，确认后再逐步授权电脑操作。