切换深浅色
WorkBuddy 接入 XXAPI
让 AI 帮你完成配置
首次安装或切换到 XXAPI，都可以使用。
AI 打不开链接时，。
查看短提示词
想用带界面的 AI 助手处理文件、整理资料，可以从 WorkBuddy 开始。这一页只需要在设置里填地址、密钥和模型名称。
1. 准备好软件和密钥
从 WorkBuddy 官网 下载电脑对应的版本，安装后打开。如果软件要求登录，按它的提示完成登录。
打开 XXAPI 的 API 密钥页面，复制自己的 API Key。再到 模型广场 选择支持 Chat Completions 和工具调用的模型，复制完整模型 ID。
查看当前可用模型与分组从 XXAPI 后台读取
选择与你的 API Key 相同的分组，再复制模型名称。
2. 打开自定义模型设置
点击 WorkBuddy 左下角的账号或设置入口，进入 设置 → 模型。
点击 添加模型，在服务商类型中选择 Custom / 自定义。
3. 填入 XXAPI 参数
| 界面里的项目 | 填写内容 |
|---|---|
| 名称 | XXAPI，或方便自己识别的名称 |
| 服务商类型 | Custom / 自定义 |
| Base URL / API 地址 | https://xxapi.ai/v1 |
| API Key | 你刚复制的 XXAPI API Key |
| 模型 ID | 模型广场里复制的完整 ID |
| 自定义协议 | 保持关闭 |
保持“自定义协议”关闭时，WorkBuddy 会自动补上 /chat/completions。这里填写 /v1 即可，别把完整的聊天接口再粘贴进去。也不要用只能调用 Responses 接口的模型完成这一步。
保存配置。如果有图片识别、推理或工具调用等能力选项，按所选模型实际支持的能力填写，其他选项先保持默认。
4. 选中模型，发出第一条消息
回到聊天页面，打开模型选择菜单，选中刚添加的 XXAPI 模型。新建一个会话，发送下面这句话。
text
请用一句中文介绍你能帮我做什么，先不要读取或修改文件。收到回复后，打开 XXAPI 的使用日志，核对刚才的时间和模型名称。回复正常，并且 XXAPI 中有对应记录，就说明这次聊天已经接入成功。 如果没有记录，先检查 WorkBuddy 是否仍选着之前的服务商或模型。
接下来可以选择一个专门用于练习的文件夹，让它帮你列出文件；这一步还需要模型支持工具调用。熟悉确认提示后再处理正式资料。
已经配过其他服务商
在“模型”页面新增一条 XXAPI 配置，原来的配置可以保留。保存后要在聊天框重新选中 XXAPI；只新增配置，并不会自动切换已有会话。
如果只想换密钥，编辑 XXAPI 这一条即可。软件里原有的账号登录和项目设置不需要重新做。
遇到问题
| 看到的情况 | 先检查这里 |
|---|---|
| 401、密钥无效 | 重新复制完整 API Key，删除首尾空格，确认使用的是 XXAPI 的密钥 |
| 404、接口不存在 | 地址应为 https://xxapi.ai/v1，自定义协议保持关闭 |
| 模型不存在 | 对照模型广场复制完整 ID，并检查这枚密钥能否访问该模型 |
| 能聊天，但处理文件时报错 | 所选模型还需要支持工具调用；换成具备该能力的模型再试 |
| 还在用以前的模型 | 新建会话，在聊天框再次选择刚添加的模型 |