APIMODELSAPIMODELS
WorkBuddy · 自定义模型 · OpenAI 兼容

WorkBuddy 自定义模型配置:接入 apimodels.app

WorkBuddy 是腾讯推出的桌面 AI 智能体工作台。它的「自定义模型」可以接入内置模型以外的模型服务:填 URL、API Key 和模型名,WorkBuddy 只负责把请求转发过去。接 apimodels.app 后,一把 key 用 Claude、GPT、DeepSeek 等模型,按 token 从你的 apimodels 余额扣费。下面是配置步骤、MCP 接入和常见报错,WorkBuddy 侧的说法均按其官方文档核对。

需要填的三项

URLhttps://api.apimodels.app/v1/chat/completions
API Keyapimodels 控制台创建的 sk_… key
模型名claude-fable-5-2 · gpt-6.2-sol · deepseek-v4.1-flash

没有 key 就到 控制台 → API Keys 创建。建议给 WorkBuddy 单独建一把,不用时删掉即失效。

添加自定义模型(4 步)

  1. 单击头像 → 设置 → 模型,添加模型。
  2. 接入方式选「自定义 / Custom」(不在提供商列表里的服务都走这里)。
  3. URL 填 https://api.apimodels.app/v1/chat/completions,API Key 填 apimodels 的 sk_… key,模型名填模型 ID。
  4. 保存。对话框的模型选择器里,自定义模型单独一组,选中即可开始用。
  • URL 填到 /chat/completions 为止。高级配置里的「自定义协议」保持关闭(默认):关闭时 WorkBuddy 按标准 /chat/completions 路径校验地址,打开后会原样使用你填的地址,所以填完整地址两种情况都对。
  • 模型名必须和模型页上的 ID 逐字一致,包括点、横杠和小写,例如 deepseek-v4.1-flash 不能写成 DeepSeek-V4.1-Flash。
  • 配置(含 API Key)只保存在本机的 workbuddy/models.json,不上传云端;用界面增删改即可,不用手动编辑这个文件。

模型名填哪个

WorkBuddy 要调用工具才能读写文件、操作软件,下面三个都支持工具调用。要用别的模型,再添加一条自定义模型,模型名换成它的 ID;完整列表见 模型目录。价格以各模型页为准。

Claude Fable 5.2claude-fable-5-2长流程任务、复杂文档和代码;1M 上下文。
GPT-6.2 Solgpt-6.2-sol日常任务的默认选择;1.05M 上下文,支持函数调用。
DeepSeek V4.1 Flashdeepseek-v4.1-flash响应快,适合大量简单任务;1M 上下文,支持工具调用。

接入 apimodels MCP:在 WorkBuddy 里生成图片和视频

MCP(模型上下文协议)用来把外部工具接进 WorkBuddy。自定义模型只管对话;装上 apimodels 的 MCP 服务器后,WorkBuddy 还能调用 generate_image、generate_video、text_to_speech 等工具,用站上的图片、视频、语音模型。在 WorkBuddy 桌面端打开侧边栏 插件 → MCP 服务器 → 配置 MCP,把下面这段加进 mcp.json(用户级文件在 ~/.workbuddy/mcp.json,只给某个项目用就放 <项目目录>/.workbuddy/mcp.json):

{
  "mcpServers": {
    "apimodels": {
      "command": "npx",
      "args": ["-y", "apimodels-mcp"],
      "env": {
        "APIMODELS_API_KEY": "sk_…your_apimodels_key…"
      }
    }
  }
}
  • 需要电脑装有 Node.js(用到 npx)。保存后状态灯变绿即连接成功,变红就检查 JSON 括号引号和 Node.js。
  • 也可以在 专家·技能·连接器 → 连接器 → 右上角「自定义连接器」里添加,填法和上面相同。
  • 装好后直接用大白话提需求,比如「用 apimodels 生成一张 16:9 的产品图」。生成按各模型页价格扣费,失败不扣费。工具清单见 /docs/mcp。

用自定义模型还要付 WorkBuddy 的费用吗

WorkBuddy 官方文档写的是:自定义模型产生的全部费用(Token、订阅等)由你向第三方支付。接 apimodels.app 时,就是按我们模型页上的每百万 token 价格从你的 apimodels 余额扣费,失败的请求不扣费。腾讯云上的 WorkBuddy Enterprise 文档另外写明:使用联网搜索时,WorkBuddy 默认用内置模型汇总搜索结果,这一步会少量消耗积分。

常见报错

症状原因 / 修法
404地址拼错,比如 /v1 或 /chat/completions 写了两遍。改成 https://api.apimodels.app/v1/chat/completions。
401 / Invalid or missing API keykey 填错、多了空格,或已在控制台删除。重新复制一把 sk_… key。
WorkBuddy 错误码 4100这个自定义模型没填 URL 或 API Key,请求没有发出。点提示里的「前往配置」补全并保存,不用重启。
模型名报错模型名和我们的模型 ID 不一致。照模型页逐字填写,或 GET https://api.apimodels.app/v1/models 查完整列表。
402 / 余额不足apimodels 余额用完了,到控制台充值即可。

依据(2026-11-18 核对):WorkBuddy 官方文档 模型配置 · MCP · 连接器 · 错误码 · 腾讯云 WorkBuddy Enterprise 模型配置。WorkBuddy 是腾讯的产品,与 apimodels.app 没有隶属关系。

常见问题

WorkBuddy 自定义模型是什么意思?

就是让 WorkBuddy 用你自己选的模型服务,而不是内置模型:在设置 → 模型里填 URL、API Key 和模型名,WorkBuddy 只负责转发请求。WorkBuddy 官方文档写明这份配置(含 API Key)只保存在本机的 workbuddy/models.json,不上传云端,费用由你直接付给模型服务方。接 apimodels.app 时,URL 填 https://api.apimodels.app/v1/chat/completions,模型名填我们的模型 ID,比如 claude-fable-5-2。

WorkBuddy 自定义模型怎么配置?

单击头像 → 设置 → 模型,添加模型时选「自定义 / Custom」,填三项:URL 填 https://api.apimodels.app/v1/chat/completions,API Key 填 apimodels 控制台创建的 sk_… key,模型名填模型 ID,比如 gpt-6.2-sol、claude-fable-5-2、deepseek-v4.1-flash,要逐字一致。保存后在对话框模型选择器的自定义分组里选中即可。高级配置里的「自定义协议」保持默认关闭,WorkBuddy 会按标准 /chat/completions 路径校验地址。

WorkBuddy 自定义模型报错怎么办?

先看报错:404 多半是地址拼错,比如 /v1 或 /chat/completions 写了两遍,应为 https://api.apimodels.app/v1/chat/completions;401 Invalid or missing API key 是 key 填错或已删除,到控制台重建一把;WorkBuddy 自己的错误码 4100 表示这个自定义模型没填 URL 或 API Key,点「前往配置」补全即可;报模型名的错,是模型名和我们的模型 ID 不一致,照模型页复制;402 是 apimodels 余额不足,充值即可。

WorkBuddy 用自定义模型还要收费吗?

WorkBuddy 官方文档的说法是:自定义模型产生的全部费用(Token、订阅等)由你向第三方支付。接 apimodels.app 就是按我们模型页上的每百万 token 价格从 apimodels 余额扣费,失败的请求不扣费。腾讯云上的 WorkBuddy Enterprise 文档另外写明:使用联网搜索时,WorkBuddy 默认用内置模型汇总搜索结果,这一步会少量消耗积分。

WorkBuddy 的 MCP 是什么?怎么接入 apimodels 的 MCP?

MCP(模型上下文协议)用来把外部工具接进 WorkBuddy。在桌面端打开侧边栏 插件 → MCP 服务器 → 配置 MCP,在 mcp.json(用户级在 ~/.workbuddy/mcp.json)里加入:{"mcpServers": {"apimodels": {"command": "npx", "args": ["-y", "apimodels-mcp"], "env": {"APIMODELS_API_KEY": "sk_…"}}}}。电脑需要装有 Node.js。状态灯变绿后,直接用大白话让它生成图片、视频或配音,按各模型页价格扣费。也可以在 专家·技能·连接器 → 自定义连接器 里添加,填法相同。

WorkBuddy 的 API key 从哪来?填进去安全吗?

WorkBuddy 自定义模型里的 API Key 来自你接入的模型服务方。接 apimodels.app 就到 apimodels 控制台 → API Keys 创建一把 sk_… key。WorkBuddy 官方文档说明 API Key 只保存在本地的 workbuddy/models.json,不上传云端。建议给 WorkBuddy 单独建一把 key,不用时在控制台删掉即失效。