WorkBuddy 接入
更新时间: 2026/11/12 14:29:54
WorkBuddy 是桌面 AI Agent 工作台,支持通过 自定义模型 以 OpenAI-compatible 方式接入云信大模型 API 平台(简称 AIHub)。
安装 WorkBuddy
-
前往 WorkBuddy 官网,点击 立即下载。
-
根据操作系统下载安装包并完成安装。
-
启动后按页面提示登录 WorkBuddy 账号。
配置接入凭证
-
在对话界面底部点击模型选择器,在列表底部选择 配置自定义模型;或从左下角头像进入 设置,在左侧导航的功能分组中选择 模型。
-
点击 添加模型,供应商选择 自定义。
-
按以下示例填写接口地址、API Key 与模型名称。填写完后可点击 测试连接 确认接口连通。
WorkBuddy 配置项 说明 供应商 自定义 接口地址 $AIHUB_BASE_URL/v1/chat/completions,例如https://ai.yunxinapi.com/hub/v1/chat/completionsAPI Key AIHUB_TOKEN,即 AIHub API 密钥/访问令牌模型名称 AIHub 逻辑模型名称 配置示例:
text
接口地址: https://ai.yunxinapi.com/hub/v1/chat/completions API Key: sk-... 模型名称: your-logical-model -
点击 保存。
- 接口地址 不会自动补全,需填写完整的 Chat Completions 地址(结尾为
/chat/completions),见上方配置示例。 - 自定义模型仅支持 OpenAI 兼容的 Chat Completions 协议,不支持 Responses API 与 Anthropic 协议,因此不要填写 AIHub 的
/v1/messages入口。
验证配置
保存后,在对话界面底部的模型选择器中选择该模型,发送:
text只回复 OK
如果模型正常返回响应,说明配置已生效。
常见问题
| 现象 | 排查方向 |
|---|---|
| 测试连接失败 | 接口地址未填写完整的 /chat/completions 地址,或误填了 AIHub 的 Anthropic Messages 入口。 |
| 报错模型不存在 | 模型名称会作为请求中的 model 参数发送,须与 AIHub 逻辑模型名完全一致(区分大小写,不带额外前后缀)。 |
401/unauthorized |
API Key 应填写 AIHub 访问令牌(AIHUB_TOKEN)。 |
404 |
接口地址缺少 /hub/v1/chat/completions,或误把根地址填入了不会自动补全的字段。 |
| 填写的模型不可用 | 先用 /v1/models 查询当前令牌可见的模型列表,并按其 data[].id 填写模型名称。 |
model not allowed/no candidate |
当前访问令牌未授权该模型,或模型无可用路由。 |
此文档是否对你有帮助?




