WorkBuddy 接入第三方模型 API 全流程:安装与配置实录

WorkBuddy 默认使用内置模型通道,安装后即可开始对话。如果你希望统一管理模型账单、自由切换模型,或者把请求接到自己的 OpenAI 兼容接口,也可以把它配置为自定义供应商。

本文从下载安装开始,完整走一遍「安装 → 登录 → 添加自定义模型」的流程。文中截图均来自实际安装过程,界面内容已做隐私处理。

一、下载安装包

从官方下载页进入:

text 复制代码
https://www.codebuddy.cn/work/

页面会提供对应平台的安装包入口,包括 Mac ARM64、Mac x64 和 Windows x64。

本文机器下载的是 Apple Silicon 版本,安装包约 341 MB。下载完成后,会得到一个 .dmg 文件。

二、安装

macOS 安装包使用标准的拖拽式安装:

  1. 双击 DMG 打开安装窗口;
  2. 将左侧的 WorkBuddy.app 拖入右侧的「应用程序」文件夹;
  3. 首次打开时,如出现来源确认提示,核对发布者后继续。

从「应用程序」启动后,会先看到欢迎页。

三、登录

点击欢迎页中的「登录」,随后会跳转到浏览器完成账号认证。当前登录页支持微信扫码,也提供手机号、邮箱和 SSO 入口。

扫码或完成其他方式的认证后,浏览器会提示登录成功。回到客户端即可进入主界面。

四、添加自定义模型 API

WorkBuddy 支持接入外部模型服务,前提是接口遵循 OpenAI 兼容协议。

进入路径:

text 复制代码
左下角账号头像 → 设置(⌘,)→ 左侧「模型」→ 右上角「添加模型」

打开的「添加模型」对话框如下,需要填写四项核心信息:

  • 供应商:选择「自定义」;
  • 接口地址:填写完整的 Chat Completions 端点,不要只填站点首页;
  • API Key:填写服务商控制台创建的调用令牌;
  • 模型名称:填写服务商实际提供的模型调用名,而不是界面显示名。

以 OpenAI 兼容的第三方站点为例,接口地址需要精确到 /v1/chat/completions:

text 复制代码
https://aiapi.market/v1/chat/completions

到这个AI算力超市加微信领取免费额度,然后在网站控制台创建API KEY。创建时要确认令牌包含目标模型的分组权限,否则调用时可能返回鉴权错误,建议直接选auto分组。模型名称请按服务商给出的实际值填写,例如:

text 复制代码
gpt-6-astra

填写完成后,点击右侧的「测试连接」。返回成功后,再点击「保存」。

「高级配置」中还有几个开关,按需选择:

  • 工具调用:模型是否支持 function calling;支持时保持开启;
  • 图片输入:模型是否支持视觉输入;
  • 思考模式:是否启用推理模式的额外参数;
  • 自定义协议:仅在接口不完全兼容 OpenAI 协议时使用。

五、验证

保存后回到主界面,在对话框左下角的模型选择处切换到刚添加的模型,然后发送一条简单指令,例如:

text 复制代码
请用一句话说明你已连接成功。

如果能够正常返回内容,说明接口地址、API Key 和模型名称三者已经对齐。

六、常见问题

下面按常见报错类型定位,具体提示请以客户端实际返回为准。

测试连接失败

按「接口地址 → API Key → 模型名称」的顺序排查。接口地址必须精确到 /v1/chat/completions;API Key 要完整复制,不要漏掉前缀;模型名称要与服务商后台给出的调用名完全一致,大小写和连字符都不要改。

model not found

通常是模型名称填写不完整,或误填了显示名。请到服务商的模型列表中复制实际调用名。

401 / 403

令牌无效,或者令牌分组没有目标模型权限。部分服务商在创建令牌时要求选择模型分组,分组不匹配就会返回鉴权错误。

保存后模型没有出现

先确认「测试连接」是否通过,再重新启动客户端并检查模型列表。如果仍然没有出现,请重新创建一条配置,避免旧的错误条目被复用。


小结:安装过程本身并不复杂,真正容易踩坑的是两个字段:接口地址要带完整端点路径,模型名称要使用服务商提供的实际调用名。把这两处对齐,第三方 API 通常一次就能接通。

相关推荐
挖掘狂人4 小时前
128GB 让 “本地跑大模型” 成为日用品,但分水岭不在硬件
人工智能
oil欧哟4 小时前
Gemini 4 系列与 Antigravity 使用心得:Carbon、Argon 与 Hydrogen 实测与提速方法
人工智能
菜鸟~noob2334 小时前
[AI]间章:系列走到这里,聊聊后面的规划、造卡需要的软件平台,以及为什么我要先暂停更新
人工智能·python·fpga开发·django·pygame
aneasystone本尊4 小时前
大模型训练系列收官:动手训一个属于自己的小模型
人工智能
杨凯凡4 小时前
Spring AI MCP 多租户安全实战:共享 Session 会串数据吗?工具权限与隔离边界
人工智能·安全·spring
chh56313 小时前
从 BERT 到大模型:让模型从“会接龙”到“会回答
人工智能·深度学习·bert
TomEval14 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
ZhengEnCi14 小时前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程
一只爱撸猫的程序猿15 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
GitCode官方15 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit