教程WorkBuddy

WorkBuddy 接入中转站：自定义模型怎么添加，接口地址怎么填

按腾讯 WorkBuddy 官方文档整理：在设置的“模型”里添加一个自定义模型，填接口地址、API key 和模型名，就能让 WorkBuddy 走中转站。讲清地址要不要写完整路径、“自定义协议”开关什么时候开、几个能力选项怎么勾，以及模型不出现、请求失败怎么查。

发布 · 约 5 分钟读完 · 经人工审核（）· 本站的内容怎么来的

本文根据公开分享整理，本站尚未实测。操作前请对照文末的原始来源。

本页目录（7 节）
  1. 开始之前：从中转站拿到三样东西
  2. 第一步：打开模型设置
  3. 第二步：添加自定义模型
  4. 第三步：选模型并验证
  5. 以前用配置文件配过的
  6. 常见问题
  7. 接上之后

WorkBuddy 是腾讯出品的 AI 办公智能体：说出要求，它自己规划任务、调用工具、生成文件。它自带一批内置模型，也允许添加自己的模型。把中转站加成一个自定义模型，就能在 WorkBuddy 里用中转站的线路。

整个过程都在图形界面里完成，不用改配置文件：

  1. 设置 → 模型 → 添加模型；
  2. 提供商选“自定义 / Custom”，填接口地址、API key 和模型名；
  3. 保存后，在对话框底部的模型选择器里选它。

先说一个限制：WorkBuddy 的自定义模型走的是 OpenAI 兼容的接口，也就是 /chat/completions 这一种。官方文档里它默认使用的就是这个标准路径；中转站一方的接入文档说得更直接，WorkBuddy 仅支持 OpenAI 兼容协议。所以你的中转站要提供这种接口，只有 Anthropic 原生接口的线路接不了。Claude 系列的模型，只要中转站通过 OpenAI 兼容接口提供，也可以用。

如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：从中转站拿到三样东西

需要什么 说明
接口地址 OpenAI 兼容接口的地址。写到哪一级见下面“接口地址怎么填”
模型名 中转站模型页上写的名字，一字不差
API key 在中转站的控制台创建，多数站只显示一次

1打开模型设置

启动 WorkBuddy，点左下角的头像，在菜单里点“设置”，再在左侧选“模型”。点击的位置取自中转站一方的接入文档，界面可能随版本变化，找“设置”里的“模型”即可。

官方文档对这个页面的说明是：已经配置的自定义模型以列表的形式展示，添加、编辑和删除都通过弹窗完成，配置保存后自动持久化。

2添加自定义模型

点“添加模型”。WorkBuddy 提供了几种接入方式，接中转站用最后一种：

接入方式 是什么 接中转站用不用
提供商接入 从列表里选一家，地址、模型列表和能力都自动填好，只需要补 API key 不用，除非你的中转站正好在列表里
Token Plan、Coding Plan 腾讯云等厂商的套餐 不用
本地部署 接本机的 Ollama 不用
自定义 / Custom 手动填地址、API key 和模型名 用这个

在弹窗里填：

配置项 填什么
提供商 自定义 / Custom
接口地址 中转站的 OpenAI 兼容接口地址
API KEY 中转站的 key
模型名称 中转站的模型名

接口地址怎么填

这是最容易填错的一项。WorkBuddy 的官方文档说明了它的默认行为：使用标准的 /chat/completions 路径，并且会自动校验和补全接口地址。

中转站一方的接入文档给的填法是写完整的路径，形如：

https://你的中转站地址/v1/chat/completions

以酷站AI 为例，它的文档写的 OpenAI 兼容接口就是 https://api.koozhan.com/v1/chat/completions。

两种说法并不冲突：按官方的描述，地址写得不完整时 WorkBuddy 会补全；直接写完整的路径最不容易出错。建议照中转站文档给的格式填，没有说明的话写完整路径。

“自定义协议”开关

高级配置里有一个“自定义协议”的开关，官方文档的解释是：

状态 行为
关闭（默认） 使用标准的 /chat/completions 路径，自动校验并补全接口地址
开启 直接按你填写的地址发请求，跳过路径的校验和自动补全

一般保持关闭。 只有当中转站的接口路径不是标准写法（比如中间经过了一层网关，路径被改过），填了标准地址不通时，才打开它，并把完整的地址一字不差地填进去。

能力选项怎么勾

弹窗里还有几个能力的选项。官方文档提到，选标准的提供商时这些标记会自动写入；选自定义时要你自己勾。

选项 什么时候勾
工具调用 模型支持函数调用就勾。WorkBuddy 要靠它调用工具，不勾的话它调用不了工具
图片输入 模型支持看图时勾
推理模式 用深度思考的模型时勾

勾了模型实际不支持的能力，用到时会报错。拿不准某个模型支不支持，查中转站或模型官方的说明。

填完点“保存”。

3选模型并验证

保存后，模型会出现在“已保存模型”的列表里。回到主界面，点对话框底部的模型选择器，在“自定义模型”这一组下面选它。

验证分两步：

  1. 发一句话。 能正常回答，说明地址、key 和模型名是对的。
  2. 交给它一个要动手的小任务，比如“把这段文字整理成一个 Word 文档”。WorkBuddy 的价值在于调用工具、生成文件，这一步通了才算真的能用。

要注意 WorkBuddy 还有一个“自动模式”：打开后它会根据任务自己选模型。想确定用的是中转站的模型，就在模型选择器里明确选中你添加的那个，不要用自动。

以前用配置文件配过的

官方文档提到，以前通过 ~/.codebuddy/models.json 配置的自定义模型，在界面升级后仍然可以正常使用，并且可以在界面里查看、编辑和删除，不用再直接改文件。

所以看到网上的旧教程让你改这个文件，现在不需要了，在设置界面里操作即可。

常见问题

现象 检查什么
保存后，模型选择器里没有它 看“自定义模型”这一组；还没有的话重启 WorkBuddy
请求失败，或提示接口错误 接口地址是否完整；key 有没有多复制空格；中转站是否提供 OpenAI 兼容接口
填了标准地址不通，中转站说路径是对的 中转站的路径可能不是标准写法，试试打开“自定义协议”，填完整地址
能聊天，但不会调用工具、不生成文件 “工具调用”有没有勾；这个模型和线路是否支持函数调用
发图片，模型说看不到 “图片输入”有没有勾
用的好像不是我加的模型 是不是开着自动模式。在模型选择器里明确选中自定义的那个
提示模型不存在 模型名和中转站模型页上的是否完全一致，包括前缀和大小写

接上之后

  • 验证拿到的是不是真模型。 能回答不等于给你的是它声称的模型。用同一把 key 到 Veridrop 检测一次，背景见中转站怎么掺假。
  • 办公文件会经过中转站。 WorkBuddy 处理的是文档、表格、邮件这类工作内容，而你的请求要经过中转站。涉及公司机密或客户数据的任务，先想清楚能不能走第三方，见用中转站有什么风险。
  • 智能体比聊天费 token。 一个任务会来回调用模型很多次。充值按用量来，开始时多看几次中转站控制台的消耗。
  • key 等同于钱。不要发到群里，不要截图；怀疑泄露就到控制台删掉重建。

来源

通过 API 中转站使用这些模型？到 Veridrop 免费检测中转站给你的是不是它声称的模型，或者看看中转站排行榜前 100 名。

相关文章

  • DeepSeek Harness（dsh）接入中转站：添加自定义模型 API，协议和地址怎么填教程 · DeepSeek Harness · 约 9 分钟

    按 DeepSeek Harness 官方文档整理：在“设置 → 模型”里添加模型提供商，切换到“自定义模型 API”，填 Provider ID、中转站地址、协议和 key，再加上模型。讲清三种协议怎么选、密钥存在哪里、中转站拒绝请求时改哪两个兼容开关，以及常见报错怎么查。

  • Chatbox 接入中转站：添加自定义的模型提供方，电脑和手机都能用教程 · Chatbox · 约 5 分钟

    按 Chatbox 官方文档整理：在设置的“模型提供方”里点添加，选 API 类型，填中转站的 key 和主机地址，加上模型后点“检查”。讲清 API 主机和路径怎么分、模型能力怎么勾、一键导入配置要注意什么，以及检查失败时各个错误码的含义。

  • Cherry Studio 接入中转站：添加自定义服务商，地址填到哪一级教程 · Cherry Studio · 约 5 分钟

    按 Cherry Studio 官方文档整理：在“模型服务”里添加自定义服务商，填中转站的 key 和地址，获取模型列表后打开启用开关。讲清地址为什么通常只填根地址、什么时候在末尾加

  • 沉浸式翻译接入中转站：自定义接口地址要写完整路径教程 · 沉浸式翻译 · 约 5 分钟

    按沉浸式翻译官方文档整理：在翻译服务里填中转站的 key、模型名和自定义接口地址，就能用中转站的模型翻译网页。和多数工具不同，这里的地址要写到 /v1/chat/completions 为止。讲清两种填法、出现 429 时怎么调请求数，以及翻译这种用法要留意的费用和隐私。