# 在 WorkBuddy 中把 Router One 添加为自定义模型

> https://router.one/zh/integrations/workbuddy 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-10-09

WorkBuddy 是腾讯推出的办公 AI Agent。除了内置模型，它也支持自定义模型：按 WorkBuddy 的模型配置文档（2026-10-09 核对），在「设置 → 模型」中添加模型，提供商选「自定义 / Custom」，再填写接口地址、API Key 和模型名称。接口地址填 https://api.router.one/v1/chat/completions，模型名称填 Router One 目录中的模型 ID，这个模型的请求就会用你的 Key 发到 Router One。WorkBuddy 的自定义模型使用 OpenAI 兼容格式，这对 Router One 已经足够：目录中的全部对话模型（包括 Claude）都通过 POST /v1/chat/completions 提供，所以一把 Key 就能用上 Claude、GPT、Gemini、Grok 和 DeepSeek 对话模型，网关发往模型的每个请求都记录在控制台 → 日志中（在输出任何内容之前就失败的流式请求可能没有记录）。本指南按 WorkBuddy 的模型配置文档与更新日志核对（2026-10-09），当时的最新版本是 5.7.6（2026-10-04 发布）。

## 先创建专用 Key，并选好精确的模型 ID

在控制台 → API 密钥点「创建密钥」，为 WorkBuddy 单独建一把 Key，并设置 maxSpend 上限。WorkBuddy 的模型配置文档提醒：使用过程中可能持续触发模型调用，建议密切关注你在第三方的账户费用。在 Router One 一侧，maxSpend 就是硬性上限，专用 Key 也方便在控制台 → 日志里只筛出 WorkBuddy 的请求。然后从 /models 原样复制要用的对话模型 ID，例如 anthropic/claude-sonnet-5、openai/gpt-5.6-sol、google/gemini-3.5-flash 或 deepseek-v4.1-flash，带厂商前缀的 ID 要保留前缀。「自定义」对话框只能填一个模型名称，想在 WorkBuddy 里切换几个 Router One 模型，就逐个添加。gpt-image-2 这类图像生成 ID 不是对话模型，不要添加。

## 把 Router One 添加为自定义模型：接口地址填完整的 /v1/chat/completions

打开 WorkBuddy 的「设置 → 模型」，在「自定义模型」下点「添加模型」。「提供商」选「自定义 / Custom」——WorkBuddy 文档写明，模型服务不在提供商列表中时选它。「接口地址」填 https://api.router.one/v1/chat/completions，「API KEY」粘贴专用 Key，「模型名称」填精确的目录 ID，例如 anthropic/claude-sonnet-5。「高级配置」里的能力标记按下文勾选，「自定义协议」保持关闭，「输入」「输出」保留「使用提供商默认值」，然后点「保存」。按 WorkBuddy 文档，配置保存后会自动持久化，对话界面的模型选择器会展示自定义模型分组，从那里选中这个模型即可。填好的对话框如下：

`workbuddy-custom-model`

```text
# WorkBuddy：设置 → 模型 → 添加模型 → 提供商：自定义 / Custom
# WorkBuddy: Settings → Model → add a model → Provider: Custom
提供商 / Provider:            自定义 / Custom
接口地址 / URL:               https://api.router.one/v1/chat/completions
API KEY:                      sk-your-router-one-key
模型名称 / Model name:        anthropic/claude-sonnet-5

# 高级配置 / Advanced settings（按 /models 详情页 / per the model page）
工具调用 / Tool calling:      勾选 / on
图片输入 / Image input:       勾选 / on
自定义协议 / Custom Protocol: 关闭 / off
输入、输出 / Input, Output:   使用提供商默认值 / provider default
```

## 接口地址、「自定义协议」与 OpenAI 兼容格式

按 WorkBuddy 的模型配置文档（2026-10-09 核对），「自定义协议」是「高级配置」里的开关：关闭（默认）时，WorkBuddy 使用标准 /chat/completions 路径，自动校验并补全接口地址；开启后，它直接按你填写的地址发起请求，跳过路径校验与自动补全。文档说明，模型服务使用非标准 URL 路径（例如经过网关或代理层封装）时可以开启它。Router One 虽然是网关，Chat Completions 端点用的却是标准路径，所以保持关闭，并填写带 /v1 的完整地址 https://api.router.one/v1/chat/completions，与对话框里的示例地址是同一种写法。对话框标明仅支持 OpenAI 兼容协议 API，这已覆盖目录中的全部对话模型：Router One 在 POST /v1/chat/completions 上同样提供 Claude、GPT、Gemini、Grok 与 DeepSeek 的 ID。Router One 的 Messages 端点 POST https://api.router.one/v1/messages 面向 Claude Code 这类基于 Anthropic 格式的客户端，WorkBuddy 的自定义模型用不到它。

## 能力标记、输入与输出

按 WorkBuddy 文档，从提供商列表中选择标准提供商时，工具调用、图片输入、推理模式等能力标记会自动写入；选「自定义」时需要在「高级配置」里自己勾选，依据是 /models 上该模型的详情页：

- 工具调用：详情页列出工具调用时勾选。WorkBuddy 的自定义模型走 /chat/completions 路径，所以 GPT-6 系列要注意 OpenAI 的端点规则：按 OpenAI 的 GPT-6 指南（2026-10-09 核对），GPT-6 Astra 与 GPT-6.1 Sol 的工具调用只走 Responses API，且不接受推理强度 none；GPT-6 Sol 在 Chat Completions 上只有推理强度为 none 时才能调用函数。WorkBuddy 里需要用到工具的任务，请选不受这些规则限制、且详情页列出工具调用的模型，例如 anthropic/claude-sonnet-5。
- 图片输入：只有详情页标明支持图片输入时才勾选，例如 deepseek-v4-flash 只支持文本。
- 推理模式：模型详情页没有对应的能力标签，只给会推理的模型勾选。
- 输入、输出：默认都是「使用提供商默认值」。如果要设「输入」，不要超过详情页上的上下文窗口；「输出」只在你想自设上限时填写。

## 费用：自定义模型的请求记在你的 Router One Key 上

WorkBuddy 的模型配置文档（2026-10-09 核对）在「积分消耗说明」中写明：自定义模型产生的全部费用（Token、订阅等）由你向第三方支付；用 Router One 的模型时，这个第三方就是 Router One。在 Router One 一侧，套餐档位列出的模型先扣对应档位的额度，额度用完后从钱包扣费；其他模型按 token 从钱包扣费，价格见模型详情页；各套餐包含哪些模型、额度多少，以 /pricing 为准。同一份文档还提到，每一轮对话都会把当前上下文完整发送给模型，所以上下文越大，每次请求带的输入 token 越多。在控制台 → 日志中按 WorkBuddy 专用的 Key 筛选，每条记录显示模型、Token、费用、状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）。Router One 在国内可直连，钱包支持支付宝充值。

## WorkBuddy 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 WorkBuddy 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

## WorkBuddy 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

## 在请求日志里核对 WorkBuddy 的调用

先在 WorkBuddy 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

## 常见问题

### WorkBuddy 的自定义模型还要收费吗？

按 WorkBuddy 的模型配置文档（2026-10-09 核对），自定义模型产生的全部费用（Token、订阅等）由你向第三方支付；用 Router One 的模型时，就由你的 Router One 账户支付。调用你的套餐档位列出的模型时，从对应档位的额度里扣；其他请求以及超出额度的请求，按模型详情页公示的价格从钱包扣费。建议为 WorkBuddy 单独建一把设了 maxSpend 上限的 Key，并在控制台 → 日志和控制台 → 用量里查看花费。

### WorkBuddy 能通过 Router One 用 Claude 吗？

能。WorkBuddy 的自定义模型使用 OpenAI 兼容格式，而 Router One 在 POST /v1/chat/completions 上提供 anthropic/claude-sonnet-5 等 Claude 系列 ID，也提供 GPT、Gemini、Grok 与 DeepSeek 的 ID。接口地址不变，模型名称换成 Claude 的 ID 即可。Router One 的 Messages 端点 POST https://api.router.one/v1/messages 面向 Claude Code 这类基于 Anthropic 格式的客户端。

### 接口地址填 https://api.router.one/v1，还是完整的 /v1/chat/completions？

填完整的 https://api.router.one/v1/chat/completions。按 WorkBuddy 的文档（2026-10-09 核对），「自定义协议」关闭时 WorkBuddy 使用标准 /chat/completions 路径，自动校验并补全接口地址；Router One 的端点就在这个路径上，对话框里的示例地址也是同样的完整写法。所以「自定义协议」保持关闭，地址里保留 /v1。

### WorkBuddy 和 CodeBuddy 的配置有什么不同？配置保存在哪里？

两者都来自腾讯。CodeBuddy Code 与 CodeBuddy IDE 是编程工具，从 models.json 文件读取自定义模型，见 CodeBuddy 接入指南；WorkBuddy 是办公 AI Agent，在「设置 → 模型」里用图形界面添加自定义模型。按 WorkBuddy 的文档（2026-10-09 核对），配置（含 API Key）只保存在本地的 workbuddy/models.json 中；以前通过 ~/.codebuddy/models.json 配置的自定义模型仍可正常使用，也可以在界面里查看、编辑或删除。不再使用某把 Key 时，在 WorkBuddy 里删除对应的自定义模型，并到控制台 → API 密钥吊销这把 Key。

### WorkBuddy 能通过网关用哪些模型？

选用当前目录中同时支持 WorkBuddy 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只说明它从自身配置或 GET /v1/models 读到了这个 ID，仍需验证实际调用。

### 能列出模型，但调用报 400 或 404，怎么办？

先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/402/403/429 怎么排查？

先看客户端收到的响应：状态码、错误消息和 X-Request-ID 响应头。401（Key 缺失、不存在、已吊销或已过期）、402（钱包余额不足，或这把 Key 达到 maxSpend 上限）以及 Key 或账户自身限额触发的 429，都在调用任何模型之前被拒绝，不会出现在控制台 → 日志里；模型 ID 或端点写错导致的 400 / 404 也一样。401 查 Key 是否完整传入、在控制台 → API 密钥里是否仍有效；402 充值或调高这把 Key 的 maxSpend；403 请保留完整错误消息。429 请退避后重试；日志里能查到的 429 是网关重试之后上游仍返回的。保留 request_id，再按错误码速查页逐项排查。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- WorkBuddy 的 API 错误排查：https://router.one/zh/llm-api-error-codes
- API 兼容性：端点与功能对照：https://router.one/zh/facts/api-compatibility.md
- Responses API 配置与限制：https://router.one/zh/codex-responses-api
- Cline 接入：https://router.one/zh/integrations/cline
- Aider 接入：https://router.one/zh/integrations/aider
- CodeBuddy 接入：models.json 自定义模型：https://router.one/zh/integrations/codebuddy
- 通过网关使用工具调用：https://router.one/zh/llm-tool-calling
- 连接与 /v1 路径排查：https://router.one/zh/api-connection-troubleshooting
- 支付宝充值：https://router.one/zh/alipay-llm-api
- WorkBuddy 官方文档：模型配置：https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model
- WorkBuddy 更新日志：https://www.workbuddy.cn/docs/workbuddy/Changelog
- 统一 LLM API 网关概览：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/workbuddy
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md