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

先创建专用 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 文档，配置保存后会自动持久化，对话界面的模型选择器会展示自定义模型分组，从那里选中这个模型即可。填好的对话框如下：

接口地址 / URL

https://api.router.one/v1/chat/completions

# 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；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

常见问题