WorkBuddy 接入免费大模型 API：以火山方舟免费额度为例（自定义模型配置教程）

准备

• 已安装 WorkBuddy（官网：workbuddy.cn，Windows / Mac 都有安装指南）
• 一个兼容 OpenAI 接口的 API Key：还没有的话，先看本站指南《火山方舟新用户免费推理额度领取 + 创建 API Key》
• 要用的模型 ID（火山方舟在 模型列表 查，SiliconFlow 在 模型广场 查）

步骤

1. 01

   先弄清 WorkBuddy 是什么、自定义模型怎么计费

   WorkBuddy 是腾讯云推出的全场景桌面 AI 智能体，支持本地操作电脑、多模型切换。它的「自定义模型」功能允许你接入第三方大模型：WorkBuddy 只负责把你的输入转发给你配置的模型，费用由你直接向该模型平台支付——所以接入有免费额度的平台，就等于用免费额度驱动 WorkBuddy。

2. 02

   打开设置 → 模型 → 添加模型

   • 启动 WorkBuddy，单击左下角账户（头像），选择设置；
   • 在左侧导航中选择模型；
   • 在「自定义模型」区域单击添加模型。
3. 03

   提供商选择「自定义 / Custom」

   在提供商列表里选择自定义 / Custom，手动填写接口地址、API Key 和模型名。

   如果你用的平台已经出现在提供商列表的预设入口里，也可以直接选它，官方文档说明选择预设后 URL、能力标记会自动填充，只需补 API Key。

4. 04

   接口地址：填完整路径，以 /chat/completions 结尾

   这是新手最容易填错的一项。腾讯云文档的示例填的是完整接口路径，不是只填到 /v1：

   • 火山方舟：https://ark.cn-beijing.volces.com/api/v3/chat/completions（方舟数据面 Base URL 为 https://ark.cn-beijing.volces.com/api/v3，再拼上 /chat/completions）
   • SiliconFlow（硅基流动）：https://api.siliconflow.cn/v1/chat/completions（官方 Base URL 为 https://api.siliconflow.cn/v1）

   注意：这里和 Cherry Studio 等工具「只填 Base URL」的习惯不同，别照搬。

5. 05

   填 API Key 和模型名称（必须是准确的模型 ID）

   • API Key：粘贴你在平台控制台创建的 Key，建议直接复制，别多带空格；
   • 模型名称：填平台给出的准确模型 ID，不能自己起名。例如火山方舟官方示例中的 doubao-seed-2-1-pro-260628，SiliconFlow 官方示例中的 Pro/deepseek-ai/DeepSeek-R1（模型会更新，以各平台模型列表为准）。

   火山方舟用 API Key 鉴权时，model 填模型 ID 即可；只有用 Access Key 鉴权时才需要填 Endpoint ID。

6. 06

   高级设置：按模型能力勾选工具调用 / 图片输入 / 推理模式

   高级设置不是必填项，但 WorkBuddy 作为 Agent 干活时很依赖工具调用。腾讯云文档建议勾选：工具调用、图片输入、推理模式——前提是你选的模型确实支持：

   • 模型不支持看图，就别勾「图片输入」；
   • 不是推理（思考）模型，就别勾「推理模式」。

   高级设置里还有一个「自定义协议」开关，默认关闭即可（关闭时 WorkBuddy 按标准 /chat/completions 路径校验并补全地址；只有走网关、代理等非标准路径时才需要打开）。

7. 07

   保存，然后在模型下拉框里选中它

   单击保存。回到对话界面，在模型选择框的自定义模型分组里选中刚添加的模型，就可以开始对话和派任务了。

8. 08

   （进阶）直接编辑 models.json 配置

   图形界面已经够用，一般不需要改文件。WorkBuddy 文档说明自定义模型配置（含 API Key）只保存在本地的 models.json 里；腾讯云的 models.json 配置指南给出的用户级路径是 ~/.codebuddy/models.json（WorkBuddy 文档也说明通过该文件配置的模型界面升级后仍可用、可在界面里编辑）。示例如下，url 同样必须是以 /chat/completions 结尾的完整路径：

   文档说明配置文件支持热重载，保存后会自动生效；如果模型没出现，先检查 JSON 格式（逗号、引号），再完全退出并重新打开 WorkBuddy 试试。

   json复制

   {
     "models": [
       {
         "id": "doubao-seed-2-1-pro-260628",
         "name": "豆包（火山方舟）",
         "vendor": "Volcengine",
         "url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
         "apiKey": "你的API Key",
         "maxInputTokens": 128000,
         "supportsToolCall": true,
         "supportsImages": false,
         "supportsReasoning": true
       }
     ]
   }

注意事项

• 只支持 OpenAI 接口格式：腾讯云 models.json 指南写明目前仅支持 OpenAI 接口格式的 API，选平台时认准「兼容 OpenAI」。
• API Key 明文存在本地：配置只保存在本机 models.json、不上传云端，但 apiKey 字段里就是实际密钥值。别在共享电脑上配置，也别把这个文件发给别人；不用了记得删掉。
• Agent 任务很费 Token：官方提醒使用过程中可能持续触发模型调用，建议密切关注第三方账户费用。用免费额度时，建议在火山方舟开好「安心体验模式」或用量上限，额度用完即停、避免扣费。
• 模型 ID 必须一字不差：大小写、前缀（如 SiliconFlow 的 Pro/）都要和平台模型列表一致。
• 火山方舟用户注意：如果你订阅的是 Coding Plan，它的 Base URL 和上面的普通数据面地址不同，请按方舟 Coding Plan 文档填写，避免地址错误产生额外费用。

常见问题

相关优惠

• 新人 · 火山引擎火山方舟新用户免费推理额度每个模型 50 万 tokens（以控制台显示为准）
• 额度 · 火山引擎豆包大模型送 50 万 tokens注册送 50 万 tokens

信息来源

• WorkBuddy · 模型配置www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model
• 腾讯云 TokenHub · 在 WorkBuddy 中配置cloud.tencent.com/document/product/1823/131902
• 腾讯云 · models.json 配置指南cloud.tencent.com/document/product/1831/134513
• 火山方舟 · Base URL 及鉴权docs.volcengine.com/docs/ark/base-url-and-authentication
• SiliconFlow · 快速上手docs.siliconflow.cn/cn/userguide/quickstart

最后核实日期：2026-10-08 · 政策可能随时调整，请以官方页面为准