使用手册
第 9 章 使用 KHaiXAPI 接入模型 API
通过 KHaiXAPI 大模型网关为 WorkBuddy 配置 OpenAI 兼容模型，统一管理 API Key、模型和用量。
WorkBuddy 支持接入其他 LLM API，也支持 Coding Plan、Token Plan 等套餐和本地 Ollama。本章以 OpenAI 兼容协议为例，介绍如何通过 KHaiXAPI 统一接入和管理模型。
对于需要模型 API Key 的配置，建议优先使用 KHaiXAPI 大模型网关，不必分别向不同模型厂商申请和管理多套 Key。你可以在同一个控制台创建密钥、查看调用记录和用量，再从模型广场选择当前可用的模型。
接入前准备
- 进入 KHaiXAPI 控制台，为 WorkBuddy 创建一枚独立的 API Key。
- 打开模型广场，选择当前可用并支持所需能力的文本模型，记下准确的模型 ID。
- 不要把真实 API Key 写进文档、截图、任务提示词或公开仓库。
为 WorkBuddy 单独创建密钥，后续可以更容易地区分调用来源、查看用量，并在密钥泄露时单独停用。
在 WorkBuddy 中添加 KHaiXAPI 模型
从 WorkBuddy 的设置入口进入：
选择“模型”：
点击“添加模型”：
添加模型时，WorkBuddy 会同时显示可用的 Coding Plan、Token Plan 和自定义 API 等选项。若使用 KHaiXAPI，在提供商列表中选择 自定义 / 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 或其他套餐，请选择对应的提供商或套餐入口，并使用该服务自己的凭证和模型配置。KHaiXAPI 密钥只用于 KHaiXAPI 网关，不能替代其他服务的凭证。
模型 API Key 与第三方服务凭证的区别
KHaiXAPI 提供的是大模型调用网关。腾讯文档、WPS、GitHub、微信公众号、腾讯会议等 Skill 或连接器要求的账号授权、API Key、Token，仍需在对应服务中申请，不能使用 KHaiXAPI 密钥替代。
可选：使用本地 Ollama
如果希望完全在本机运行，也可以接入 Ollama。需先在本地启动 Ollama（默认端口 11434，提供 OpenAI 兼容接口）；其优势是数据不出本机、可离线，并且没有云端 Token 调用费用。