WorkBuddy 实战蓝皮书
第 9 章 使用 KHaiXAPI 接入模型 API
通过 KHaiXAPI 大模型网关为 WorkBuddy 配置 OpenAI 兼容模型，统一管理 API Key、模型和用量。
对于需要模型 API Key 的配置，建议优先使用 KHaiXAPI 大模型网关，不必分别向不同模型厂商申请和管理多套 Key。你可以在同一个控制台创建密钥、查看调用记录和用量，再从模型广场选择当前可用的模型。
推荐接入方式：KHaiXAPI 大模型网关
进入控制台创建 API Key · 查看模型广场 · 查看文本 API 文档
接入前准备
- 进入 KHaiXAPI 控制台，为 WorkBuddy 创建一枚独立的 API Key。
- 打开模型广场，选择当前可用并支持所需能力的文本模型，记下准确的模型 ID。
- 不要把真实 API Key 写进文档、截图、任务提示词或公开仓库。
为 WorkBuddy 单独创建密钥，后续可以更容易地区分调用来源、查看用量，并在密钥泄露时单独停用。
在 WorkBuddy 中添加 KHaiXAPI 模型
从 WorkBuddy 的设置入口进入：
选择“模型”：
点击“添加模型”：
WorkBuddy 当前支持 OpenAI 兼容协议 API。在提供商列表中选择 自定义 / Custom，不要选择某个模型厂商的预设项：
按照下面的内容填写：
| WorkBuddy 字段 | 填写内容 |
|---|---|
| 提供商 | 自定义 / Custom |
| 接口地址 | https://api.khaix.net/v1/chat/completions |
| API Key | 在 KHaiXAPI 控制台为 WorkBuddy 创建的密钥 |
| 模型名称 | 模型广场中当前可用的准确模型 ID |
这里的“接口地址”需要填写完整的 Chat Completions 地址，不要只填写 https://api.khaix.net/v1。高级配置先保持默认；只有在模型广场和实际测试确认模型支持时，再开启工具调用、图片输入或思考模式等能力。
保存后，在新任务中选择刚添加的模型，发送一句简单问题进行连通测试。若返回鉴权错误，检查 API Key；若提示模型不存在，重新核对模型广场中的模型 ID；若请求地址错误，确认末尾包含 /v1/chat/completions。
模型 API Key 与第三方服务凭证的区别
KHaiXAPI 提供的是大模型调用网关。腾讯文档、WPS、GitHub、微信公众号、腾讯会议等 Skill 或连接器要求的账号授权、API Key、Token，仍需在对应服务中申请，不能使用 KHaiXAPI 密钥替代。
可选：使用本地 Ollama
如果希望完全在本机运行，也可以接入 Ollama。需先在本地启动 Ollama（默认端口 11434，提供 OpenAI 兼容接口）；其优势是数据不出本机、可离线，并且没有云端 Token 调用费用。