文档 › 接入教程 · English

在 WorkBuddy 里使用 SteadyRouter

WorkBuddy 是腾讯出的桌面 AI 工作台，可以接自己的模型服务。它接自定义模型只认 OpenAI Chat Completions 格式，所以每个 SteadyRouter 型号都按「自定义」模型添加，地址填 SteadyRouter 的对话接口。

开始之前

1. 注册 SteadyRouter 账号。
2. 在控制台点左侧菜单的「API 密钥」，复制你的 Key。新注册的账号自带一把 Default Key，用的是「价格优先」（见下文）。想再建一把，点「创建 API 密钥」。「智能路由」保持开着：一个分组失败了，会在同一次调用里换下一个分组重试。新建的 Key 默认用「智能自动」，余额不足 US$1 时先用「价格优先」。
3. 从 WorkBuddy 官网下载安装并登录。桌面端支持 macOS 12 及以上（Apple 芯片和 Intel 都行）、Windows 10 及以上（x64）。

添加模型

1. 在 WorkBuddy 里打开「设置」→「模型」，点「添加模型」（国际版 WorkBuddy AI 是点头像 →「System Settings」→「Models」）。也可以从对话框底部的模型选择器进去。
2. 「提供商」选「自定义」。
3. 「URL」填完整的对话接口地址，带上 /v1/chat/completions：
   URL复制

   https://api.steadyrouter.com/v1/chat/completions

   高级配置里的「自定义协议」保持关着。SteadyRouter 用的是标准路径，用不着它。

4. 「API Key」填你的 SteadyRouter Key。
5. 「模型名称」填 模型广场 上的型号名，一字不差，比如 gpt-6.1-sol。型号名前面不带厂商前缀。
6. 在高级配置里，只勾这个型号真有的能力。下面的表列了推荐型号该勾哪几项；模型广场每个型号卡片上的 Tools、Vision、Reasoning 标签说的是同一件事。拿不准就不勾：勾了型号没有的能力会报错。
7. 表单上有「Test Connection」（测试连接）按钮的话，先点它核一下 URL 和 Key，再点「保存」。想用几个型号就照这样添加几个，URL 和 Key 都一样。
8. 在模型选择器里选中它，发一句话试试通不通。

推荐型号

下面每个型号都有至少两家独立供应商的分组，智能路由能把失败的请求换到别的分组。照表里的勾选。

OpenAI、Google、xAI

国内厂商

Claude 型号（比如 claude-sonnet-5-5）也能照样添加，建文件、改文件这类要调工具的任务也能做。但 WorkBuddy 是用 OpenAI 格式调它的：提示词缓存、扩展思考只有走 Anthropic 原生接口才有，WorkBuddy 不支持这个接口，所以每一步都要按原价把很长的提示词再算一遍，比上表的型号贵得多。Claude 型号的「推理模式」别勾。

一次加好几个型号

WorkBuddy 把自定义模型存在 ~/.workbuddy/models.json（Windows 上是 C:\Users\<用户名>\.workbuddy\models.json；国际版 WorkBuddy AI 的文档写的是 ~/.workbuddy-ai/models.json，Windows 上 %USERPROFILE%\.workbuddy-ai\models.json，以设置里显示的为准）。不想一个个点，可以直接往这个文件里加条目（文件内容是一个列表，新装的 WorkBuddy 里是 []），保存后 WorkBuddy 不用重启就能读到。每一条填的和上面表单一样：

[
  {
    "id": "gpt-6.1-sol",
    "name": "SteadyRouter gpt-6.1-sol",
    "vendor": "SteadyRouter",
    "url": "https://api.steadyrouter.com/v1/chat/completions",
    "apiKey": "sk-your-steadyrouter-key",
    "maxInputTokens": 128000,
    "maxOutputTokens": 8192,
    "supportsToolCall": true,
    "supportsImages": true,
    "supportsReasoning": true
  },
  {
    "id": "deepseek-v4-pro",
    "name": "SteadyRouter deepseek-v4-pro",
    "vendor": "SteadyRouter",
    "url": "https://api.steadyrouter.com/v1/chat/completions",
    "apiKey": "sk-your-steadyrouter-key",
    "maxInputTokens": 128000,
    "maxOutputTokens": 8192,
    "supportsToolCall": true,
    "supportsImages": false,
    "supportsReasoning": true
  }
]

文件里已经有别的条目的，把你的加进原来的列表，别整个覆盖。Key 是明文存在你电脑上的，WorkBuddy 还会把它抄进自己的缓存：这个文件别发给别人、别提交到代码仓库；Key 不用了或者可能泄露了，到 SteadyRouter 控制台删掉这把 Key，光在 WorkBuddy 里删型号不够。

余额不多时怎么试

新注册的账号目前自带 US$0.05 额度。每次请求前，网关按输入加上应用要求的最大输出先预扣余额；WorkBuddy 这类智能体的提示词很长，一个任务要跑好几步。余额不多时：

1. 用「智能路由」里的「价格优先」。Default Key 本来就是；别的 Key 创建时选或者之后编辑都行。
2. 先用小一点的型号，比如 gemini-3.8-flash 或 qwen3.8-flash。在「价格优先」下，同样的请求发给它们，花费只是 gpt-6-astra、gemini-4-argon 这类大型号的零头。
3. 添加模型的表单里如果能选输出长度，选最小的 8K，每次请求预扣的就少。

确认都能用了，再 充值，想的话把 Key 换回「智能自动」。

「价格优先」常常把 Pool（号池）分组排在前面：通常更便宜，有时不太稳定。不管哪种智能路由模式，都可能用到 Pool 和 Mixed（混合来源）分组；对稳定性要求高的活，关掉智能路由，在 Key 上只放云厂商或 API 分组。见 型号与分组。

出问题了怎么办

每条报错信息末尾都有 request id。发邮件到 support@steadyrouter.com 时请附上它。

更多：API 文档 · 模型广场