WorkBuddy 接自定义模型完整教程:models.json 字段全解 + 8 家平台接口地址速查

发布时间:2026/11/16 9:50:50

WorkBuddy 接自定义模型完整教程:models.json 字段全解 + 8 家平台接口地址速查 发布日期2026-08-10 | 适用版本WorkBuddy 最新版 | 话题WorkBuddy 自定义模型 · API 配置 · 模型自由WorkBuddy 的自定义模型功能允许用户将任意兼容 OpenAI 协议的第三方 API 接入到 WorkBuddy 的对话和 Agent 工作流中跳过内置积分消耗、直接调用自己的模型额度配置信息仅存储在本地~/.workbuddy/models.json文件中不上传云端。无论是 DeepSeek 官方 API、Kimi、GLM还是本地跑的 Ollama只要提供商支持 OpenAI 兼容格式就可以接进来。为什么要接自定义模型WorkBuddy 内置了 Hy3、GLM-5.2、Kimi-K3 等模型使用时按积分计费。当你在以下情况时接自定义模型更合适已有 DeepSeek、Kimi 或其他平台的 API 额度不想重复付费需要调用 WorkBuddy 内置列表里没有的模型比如某个微调版本使用 Ollama 在本地跑开源模型完全不走外网希望接入一个能统一管理多款模型的 API 中间层一个 Key 切换多模型自定义模型接入后费用由你直接向对应提供商支付与 WorkBuddy 积分完全独立。方式一图形界面操作推荐新手整个流程只需 3 步不用碰任何配置文件。第一步打开配置入口在 WorkBuddy 主界面点击底部的模型选择器默认显示当前使用的模型名在弹出的模型列表最底部找到**「配置自定义模型」**点击进入。第二步添加模型选择提供商进入「模型」设置页后点击右上角**「 添加模型」**。弹出「添加模型」对话框顶部标注「仅支持 OpenAI 兼容协议 API」。点击「提供商」下拉看到已预设的选项分类可选提供商Coding PlanKimi Coding Plan自定义 API智谱开放平台 / GLM API、Kimi 中国版、MiniMax 中国版、深度求索 / DeepSeek、Ollama 本地其他自定义 / Custom接入任意兼容接口选择预设提供商时接口地址会自动填入只需补上 API Key 即可保存。选择**「自定义 / Custom」**时需要手动填写所有字段见第三步。第三步填写接口信息并保存选择「自定义 / Custom」后表单展开四个字段接口地址填写提供商的 chat completions 端点格式为https://api.example.com/v1/chat/completionsAPI Key填入你在对应平台申请的密钥以sk-开头。模型名称填写模型的参数名即调用时传给 API 的model字段值。例如DeepSeek 官方deepseek-chat或deepseek-reasonerKimimoonshot-v1-8k或kimi-k2Ollama 本地llama3.2或qwen2.5:7b与ollama list输出一致填写完成后点**「保存」**模型会出现在 WorkBuddy 的模型选择器列表中可直接使用。方式二直接编辑 models.json适合批量配置如果需要一次添加多个模型或者通过脚本管理配置可以直接编辑本地文件macOS / Linux~/.workbuddy/models.jsonWindowsC:\Users\用户名\.workbuddy\models.json文件格式示例{models:[{id:deepseek-chat,name:DeepSeek Chat,vendor:DeepSeek,apiKey:sk-你的密钥,url:https://api.deepseek.com/v1/chat/completions,supportsToolCall:true,supportsImages:false},{id:qwen2.5:7b,name:Qwen 2.5 7B本地,vendor:Ollama,apiKey:ollama,url:http://localhost:11434/v1/chat/completions,supportsToolCall:false,supportsImages:false}]}字段说明字段必填说明id是传给 API 的 model 参数值name是下拉列表显示名称自行定义vendor是厂商标识自行填写apiKey是API 密钥Ollama 本地填ollamaurl是完整的 chat completions 地址supportsToolCall否是否支持工具调用默认 falsesupportsImages否是否支持图片输入默认 false文件保存后 WorkBuddy 会自动热重载约 1 秒延迟无需重启。高级配置选项解读图形界面的「高级配置」区域有四个选项影响模型在 WorkBuddy 内的调用行为工具调用勾选后WorkBuddy 的 Agent 和技能Skills可以让该模型调用外部工具搜索、代码执行等。模型本身需支持 Function Calling否则勾了也没效果。图片输入勾选后在对话中可以上传图片让该模型分析。需要模型为多模态视觉模型纯文本模型开了会报错。思考模式勾选后触发模型的推理链路类似 DeepSeek-R1 的think过程。仅对支持此特性的模型有意义如 DeepSeek Reasoner、某些 Kimi 版本。自定义协议勾选后WorkBuddy 直接使用你填写的接口地址原样发请求跳过自动路径补全。适用于通过 API 网关封装的非标准端点或接口地址末尾不是/chat/completions的情况。上下文窗口手动指定该模型的输入/输出 token 上限供 WorkBuddy 内部管理对话截断逻辑。不清楚可留空使用提供商默认值。各常用平台接口地址速查提供商接口地址模型名称示例DeepSeek 官方https://api.deepseek.com/v1/chat/completionsdeepseek-chat智谱 GLMhttps://open.bigmodel.cn/api/paas/v4/chat/completionsglm-5-plusKimi 中国版https://api.moonshot.cn/v1/chat/completionsmoonshot-v1-8kMiniMaxhttps://api.minimax.chat/v1/text/chatcompletion_v2MiniMax-Text-01Ollama 本地http://localhost:11434/v1/chat/completions与ollama list一致七牛云多模型 APIhttps://api.qnaigc.com/v1/chat/completions参考平台模型列表使用统一多模型 API 中间层的好处是一个 Key、一个地址WorkBuddy 里只需配置一次就能切换不同模型无需为每家提供商单独管理密钥。常见问题Q接入后显示「模型调用失败」怎么排查按顺序检查① 接口地址末尾是否有多余斜杠或路径错误② API Key 是否复制完整常见问题末尾空格③ 模型名称是否与提供商文档一致大小写敏感④ 如果接口地址不是标准/chat/completions结尾需要勾选「自定义协议」。QOllama 本地模型怎么接先确保 Ollama 已在本地运行ollama serve然后在 WorkBuddy 中选预设的「Ollama 本地 / Ollama」提供商接口地址自动填为http://localhost:11434/v1/chat/completionsAPI Key 填ollama模型名称填ollama list列出的模型名如llama3.2:latest。Q接自定义模型会消耗 WorkBuddy 积分吗不会。自定义模型的请求直接发往你填写的第三方接口费用由你向该提供商支付与 WorkBuddy 积分完全独立。Qmodels.json 里的 API Key 安全吗配置仅存在本地WorkBuddy 不会上传任何自定义模型信息到云端。但 models.json 是明文 JSON建议不要将该文件同步到公共 Git 仓库也不要分享给他人。小结WorkBuddy 的自定义模型功能本质上是一个兼容 OpenAI 协议的 API 转接层只要提供商给出标准的chat/completions端点和 API Key三步就能完成接入。图形界面适合快速配置单个模型models.json 适合批量管理或脚本化部署。核心注意点模型名称必须与提供商文档一致高级配置里的工具调用和图片输入要与模型实际能力对齐否则勾了反而会导致调用出错。WorkBuddy 文档持续更新本文配置方式基于 2026 年 8 月版本如遇界面差异以官方文档codebuddy.cn/docs/workbuddy为准。延伸阅读WorkBuddy 官方模型配置文档https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model七牛云多模型 API 接入可直接用于 WorkBuddy 自定义模型https://www.qiniu.com/ai/models
延伸阅读

更多相关文章

2026/11/10 9:29:20

Videogular2 缓冲优化与全屏控制:打造流畅视频播放体验

Videogular2 缓冲优化与全屏控制:打造流畅视频播放体验 【免费下载链接】videogular2 The HTML5 video player for Angular 2 项目地址: https://gitcode.com/gh_mirrors/vi/videogular2 Videogular2 作为 Angular 2 的 HTML5 视频播放器,为开发者…

2026/11/16 9:48:14

息烽县考电工证网上查询指南:避开中介陷阱,一步到位拿证

息烽县考电工证网上查询指南:避开中介陷阱,一步到位拿证 你是不是也遇到过这样的情况? 不知道去哪报名怕被中介坑 ,找了一个“靠谱”的机构,结果花了钱连报名都办不成,还被催着交“手续费”“保证金”?别急,这正是很多人在 息烽县考电工证…

2026/11/16 9:48:14

特种工路亚饵千万别踩坑:考过率低?真相在这!

特种工路亚饵千万别踩坑:考过率低?真相在这! 怕考不过白交培训费?特种工路亚饵证书报考前,你必须知道的真相!很多学员交了培训费,结果考试挂了,证书没拿到,钱打了水漂。千万别踩坑,这篇文章帮你避开所有雷区,手把手教你从报名到取证的全流程。…

2026/11/16 9:48:14

濮阳低压电工证报名在哪考?工地太忙根本没时间复习考试

濮阳低压电工证报名在哪考?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这是很多一线施工人员的共同烦恼。特别是像低压电工这类需要持证上岗的岗位,考试不通过就无法上岗,直接影响收入。如果你在濮阳或者周边区域从事相关工作,想了解【濮阳…

2026/11/16 9:48:14

德安安监局电工证报名怎么报名才能一次过?怕考不过白交培训费

德安安监局电工证报名怎么报名才能一次过?怕考不过白交培训费 怕考不过白交培训费?你不是一个人。身边不少朋友辛辛苦苦交了培训费,结果考试挂了,钱花了,人也焦虑了。今天就来聊聊【德安安监局电工证报名】的具体流程,怎么报名,怎么准备,确保你一次通…

2026/11/16 9:48:14

现在考高级电工证官方报名入口在哪 考试内容和报名流程全解析

现在考高级电工证官方报名入口在哪 考试内容和报名流程全解析 现在考高级电工证,很多人最担心的就是不知道去哪报名怕被中介坑,尤其是咱们这些在信阳浉河区做水利工程的同行,平时忙于项目,一听说要考证就手忙脚乱。其实, 官方报名入口…

2026/11/16 9:43:13

修理电镐需要电工证吗?怎么报名不被中介坑

修理电镐需要电工证吗?怎么报名不被中介坑 不知道去哪报名怕被中介坑,其实你不是一个人。修理电镐到底需不需要电工证?这事儿得从头说起,今天就用一个真实案例来给你说清楚。 案例背景:电镐坏了,修理工没证被叫停…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/16 0:00:11

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱 你是不是也和我一样,想考电工证,但不知道去哪报名,怕被中介坑?最近网上有不少人问“黎城电工证查询报名费多少钱”,结果一查,信息五花八门,真假难辨。别担心,今天我就从一线从业者的角度…

2026/11/16 0:00:11

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来?

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来? 之前考的证在外省能不能转过来?这个问题困扰着很多在外地打工的电工,尤其是像南阳卧龙区的建筑工人,他们常年在工地作业,手上持有电工证是基本要求,但很多人因为工作流动性大,担心证书不能转到本…

2026/11/15 4:46:37

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑