ModelGo
ModelGo

WorkBuddy 接入 ModelGo：配置与排障

WorkBuddy 支持通过自定义模型接入 OpenAI 兼容 API。配置 ModelGo 的接口地址、API Key 和模型名称后，即可使用 ModelGo 模型完成对话和办公任务。

1. 准备 API Key 和模型名称

安装 WorkBuddy，在 ModelGo 控制台创建 API Key，确认账户余额、Key 预算和模型调用权限。

模型名称需要填写 ModelGo 的平台逻辑模型名。可以在模型广场查看，也可以查询当前 Key 可用的模型：

bash
export MODELGO_API_KEY="mgk_替换为你的API_Key"
curl https://api.modelgo.ai/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

使用响应中 data[].id 的值作为模型名称，选择支持 OpenAI Chat Completions 入口的模型。

2. 添加自定义模型

进入「设置 → 模型」，点击「添加模型」。

WorkBuddy 设置中的模型入口和添加模型按钮

*官方界面示例：图中是预设供应商，接入 ModelGo 时请改选「自定义 / Custom」。*

在提供商中选择「自定义 / Custom」，按下表填写：

配置项ModelGo 填写内容
接口地址 / URLhttps://api.modelgo.ai/v1
API KeyModelGo API Key
模型名称 / Model IDModelGo 平台逻辑模型名
显示名称（如有）可填写 ModelGo · 模型名称
自定义协议保持关闭
WorkBuddy 自定义模型表单中的接口地址、API Key、模型名称和能力选项

*官方空白表单示例：按上表填写 ModelGo 参数。*

WorkBuddy 默认补全 /chat/completions，最终请求地址为 https://api.modelgo.ai/v1/chat/completions。接入 ModelGo 标准接口时无需开启「自定义协议」；该开关仅控制地址补全，不会转换为 Anthropic Messages 或 OpenAI Responses 协议。

3. 设置模型能力

如果界面提供能力选项，请按目标模型实际支持情况填写：

配置项设置方式
工具调用文件处理、工具操作等执行任务需要支持工具调用的模型，并开启对应选项。
图片输入仅在模型支持图片理解时开启。
推理模式按模型支持情况设置。
最大输入 / 输出 Token按模型和服务限制填写，初次接入可保留默认值。

模型可以回复文本，并不代表支持工具调用或图片输入；能力开关不会为模型增加能力。具体见模型协议与参数。

4. 测试连接并开始使用

点击「测试连接」，通过后保存。返回对话界面，在模型选择器的「自定义模型」分组中选中刚添加的模型，再发送「请用三句话介绍你能帮助我完成哪些办公任务」。

保存配置不会自动切换所有对话。连接测试只验证接口初步可用；文件处理和工具操作可再用指定测试文件做一次小任务验证。

常见问题

问题处理方式
模型置灰检查接口地址和 API Key 是否完整，并保存配置。
401检查密钥是否完整、有效，以及是否含多余空格或换行。
402检查账户余额、额度和预算。
403根据错误原因检查模型权限或账号状态。
404URL 填写 https://api.modelgo.ai/v1，关闭「自定义协议」，避免路径拼接错误。
model_protocol_not_offered更换支持 Chat Completions 入口的模型。
能聊天，但无法操作文件或调用工具检查模型是否支持工具调用，以及对应能力选项是否开启。
保存后仍使用原模型在当前对话的模型选择器中主动选中新增模型。

自定义模型的 API 费用由 ModelGo 侧计费，可在控制台查看用量与调用日志。排查时保留 X-Request-ID，具体见错误码与限流。

相关文档与图片来源