接入文档
ChatBox 接入指南
将熊猫算力接入 ChatBox，通过 OpenAI API 兼容模式自定义提供商。
ChatBox 是一款跨平台 AI 桌面客户端，支持通过「设置 → AI 提供商 → 添加自定义提供商」接入任何 OpenAI 兼容 API。
1 字段对照表
| 字段名称（ChatBox 设置） | 填写内容 |
|---|---|
| API 模式 / Provider | 选择 OpenAI API Compatible 或自定义 |
| API Host / Base URL | 平台网关地址（不带 /v1，ChatBox 通常自动拼接） |
| API 密钥 | 你的 API 密钥（sk-xxxxx） |
| 模型 | 从模型广场复制的模型 ID |
路径差异：ChatBox 通常自动拼接 /v1
ChatBox 在大多数版本中会自动在 Base URL 后追加 /v1，因此「API Host」字段填写不带 /v1 的地址即可（例如 https://api.example.com）。
如果你发现填入后请求路径变成 https://api.example.com/v1/v1/...，说明你多填了一次 /v1，删除即可。
不同版本的 ChatBox 行为可能略有差异，如遇 404 请尝试在 Host 末尾增删 /v1 后重试。
2 接入步骤
打开 ChatBox，点击左下角「设置」图标。
进入「AI 提供商」选项卡，选择 OpenAI API 或点击「添加自定义提供商」。
在模型字段填入从模型广场复制的模型 ID。
保存设置，发一条测试消息，确认能收到回复。
然后前往调用记录 查看调用记录。
3 常见问题
4 下一步
- 快速开始 — 回顾完整上手流程
- Cherry Studio 接入指南 — 另一款多模型桌面客户端
- 错误码大全 — 排查常见错误