主题
WorkBuddy 使用教程
WorkBuddy 支持通过自定义模型接入兼容 OpenAI API 的模型服务。本页以 FlexAPI 为例，介绍如何在 WorkBuddy 中填写 API 地址、API Key 和模型 ID。
Step 1：准备 FlexAPI
- 登录 FlexAPI。
- 选择要使用的 API 分组。
- 创建或复制 FlexAPI API Key。
- 确认当前分组已开通要使用的模型，并记下准确的模型 ID。
Step 2：打开 WorkBuddy 模型设置
打开 WorkBuddy 桌面端，进入：
text
设置 → 模型 → 添加模型在供应商列表中选择 Custom API 或 自定义 API。
WorkBuddy 官方文档说明，自定义模型可以直接通过界面配置，不需要手动修改配置文件。已有的 ~/.codebuddy/models.json 配置也可以继续使用。
Step 3：填写 FlexAPI 配置
在自定义模型表单中填写：
| 配置项 | 填写内容 |
|---|---|
| 模型名称 | 自定义名称，例如 FlexAPI GPT |
| API 地址 / Base URL | https://flexapi.me/v1 |
| API Key | 你的 FlexAPI API Key |
| 模型名称 / Model | FlexAPI 控制台中的模型 ID |
推荐先使用以下配置：
- API 地址填写
https://flexapi.me/v1，保留末尾的/v1。 - Custom Protocol / 自定义协议保持关闭，让 WorkBuddy 按标准 OpenAI Chat Completions 路径补全请求地址。
- 模型 ID 必须与 FlexAPI 控制台中的名称完全一致，例如
gpt-5.6-terra或其他当前可用模型。
填写完成后点击 保存。
API Key 安全
不要把真实 API Key 发布到公开仓库、截图或聊天记录中。如果怀疑密钥泄露，请及时在 FlexAPI 控制台撤销并重新创建。
Step 4：选择模型并测试
- 返回 WorkBuddy 主界面。
- 在模型选择器中选择刚刚创建的 FlexAPI 模型。
- 新建一个对话，发送简单测试内容：
text
请用一句话介绍你当前使用的模型。如果能够正常返回内容，说明 WorkBuddy 已经成功通过 FlexAPI 调用模型。
自定义协议什么时候开启
WorkBuddy 默认会校验并补全标准 /chat/completions 路径。只有当你的网关使用非标准 URL 路径，或 WorkBuddy 自动补全出的地址与实际接口不一致时，才需要开启 Custom Protocol / 自定义协议。
开启后，WorkBuddy 会直接使用你填写的地址，不再自动补全路径。此时请按照 FlexAPI 或当前网关提供的完整接口地址填写，并再次测试模型连接。
常见问题
401 Unauthorized
- 检查 API Key 是否复制完整，前后没有空格。
- 确认 API Key 属于当前 FlexAPI 账户和分组。
- 重新创建模型配置后再次保存。
404 Not Found
- 确认 API 地址使用
https://flexapi.me/v1。 - 默认情况下不要手动追加
/chat/completions。 - 如果 WorkBuddy 仍然自动拼接错误，再尝试开启 Custom Protocol，并按照实际接口地址填写。
模型不存在或不可用
- 检查模型 ID 是否与 FlexAPI 控制台完全一致。
- 确认当前 API 分组已开通该模型。
- 可先参考 模型与价格 查看常用模型 ID。
图片或工具调用不可用
WorkBuddy 的图片输入、工具调用和推理模式取决于所选模型以及接口能力。先使用纯文本模型完成连通性测试，再根据模型支持情况开启相关能力。