Chatbox 是很多用户用来替代网页聊天的桌面客户端。它界面简单、启动快，也支持自定义 OpenAI-compatible API，所以很适合接入 DeepAI API 中转站，把多个模型统一放到一个客户端里使用。
这篇文章讲清楚 Chatbox 里最容易填错的几个配置：API Host、Base URL、API Key、模型 ID，以及 401、404、模型不显示、连接失败时应该怎么排查。
> DeepAI Base URL：https://api.deepai.wang/v1
为什么用 Chatbox 接 DeepAI API 中转站
如果你只是在浏览器里偶尔问几句话，直接用网页端也可以。但如果你经常需要切换模型、保存本地会话、快速打开桌面客户端，Chatbox 会更顺手。
把 Chatbox 接到 DeepAI API 中转站后，常见好处是：
- 一个客户端里使用多个模型；
- 不必分别配置不同厂商的 API 地址；
- 统一使用 OpenAI-compatible API 格式；
- 可以和 Cherry Studio、Dify、Open WebUI 等工具共用同一套模型入口；
- 更容易通过 DeepAI 后台查看调用、余额和错误信息。
它的核心逻辑很简单：
Chatbox → DeepAI API 中转站 → 上游模型 → 返回回复Chatbox 负责聊天界面，DeepAI API 中转站负责模型 API 入口。
准备工作
开始之前，你需要准备：
- 已安装 Chatbox；
- 一个 DeepAI API Key；
- 至少一个可用的模型 ID；
- 网络可以访问
https://api.deepai.wang/v1； - 如果是团队使用，建议为 Chatbox 单独创建一个 Key。
如果你不确定 Key 是否可用，建议先用 curl 测试：
curl https://api.deepai.wang/v1/chat/completions \
-H "Authorization: Bearer sk-你的DeepAIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "你的模型ID",
"messages": [
{"role": "user", "content": "hello"}
]
}'curl 能通，再去 Chatbox 里配置，会少走很多弯路。
站内也可以参考：
从 curl 到 Python：如何确认 DeepAI OpenAI 兼容接口真的能用
第一步：打开 Chatbox 的模型设置
不同版本的 Chatbox 界面可能略有差异，但大致路径类似：
1. 打开 Chatbox； 2. 进入设置； 3. 找到模型提供商或 API 设置； 4. 选择 OpenAI / 自定义 OpenAI API / OpenAI Compatible； 5. 填写 API 地址、Key 和模型。
如果你的 Chatbox 版本没有自定义 API 入口，建议先升级到较新版本。DeepAI API 中转站是按 OpenAI-compatible API 使用的，所以客户端必须支持自定义 API Host 或 Base URL。
第二步：API Host / Base URL 填什么
在 Chatbox 里，API Host 或 Base URL 推荐填写：
https://api.deepai.wang/v1不要填成：
https://api.deepai.wang/v1/chat/completions这是很多人会犯的错误。多数客户端需要的是基础地址，客户端会自动拼接 /chat/completions。如果你把完整接口路径填进去，可能会导致最终请求路径重复，从而出现 404 或连接失败。
可以按下面表格理解：
| 配置项 | 应该填写 |
|---|---|
| API Host / Base URL | https://api.deepai.wang/v1 |
| API Key | DeepAI API Key |
| Model / Model ID | DeepAI 后台实际可用的模型 ID |
| API Path | 一般不用手动填 |
如果 Chatbox 同时出现 API Host 和 API Path，优先让 API Host 只保留到 /v1，不要把完整接口路径拆错。
第三步：API Key 怎么填
API Key 填 DeepAI 生成的 Key，例如：
sk-xxxxxxxxxxxxxxxx通常不要在前面加 Bearer。客户端会自动生成请求头：
Authorization: Bearer sk-xxxxxxxxxxxxxxxx如果你手动填成 Bearer sk-xxx，有些客户端会变成重复 Bearer，结果触发 401 Unauthorized。
建议不要把同一个 Key 到处复制。更好的做法是：
- Chatbox 一个 Key；
- Cherry Studio 一个 Key；
- Dify 一个 Key；
- Open WebUI 一个 Key；
- Cline / 代码 Agent 一个 Key。
这样做方便统计消耗，也方便出问题时快速停用某个客户端的 Key。
第四步：模型 ID 怎么填
模型 ID 必须和 DeepAI 后台可用模型一致。不要只看模型展示名，也不要凭感觉改大小写。
例如你在某些界面看到的是：
DeepSeek Chat但真正调用时可能需要的是：
deepseek-chat真实可用的模型 ID，以 DeepAI 后台、模型列表接口或实际测试结果为准。
如果 Chatbox 支持手动添加模型，可以先只添加一个最确定可用的模型，跑通以后再继续添加更多模型。不要一开始就批量填几十个模型，否则出错时不好判断到底是哪一个配置有问题。
第五步：保存后发送测试消息
配置完成后，新建一个对话，选择刚刚添加的模型，发送：
请用一句话解释 OpenAI Compatible API 是什么。如果能正常回复，说明基础链路已经打通：
Chatbox → DeepAI API 中转站 → 模型 → Chatbox如果失败，先看错误码，不要反复随机改配置。下面按常见错误逐个排查。
Chatbox 报 401 Unauthorized 怎么办
401 主要查 API Key：
- Key 有没有复制完整；
- Key 前后有没有空格；
- 是否多填了
Bearer； - Key 是否被删除或禁用；
- 当前 Key 是否有权限调用这个模型；
- Chatbox 是否保存到了正确的服务商配置。
最有效的判断方法是：同一个 Key 用 curl 测试。如果 curl 可以，Chatbox 不可以，优先查 Chatbox 的填写方式和保存位置。如果 curl 也不可以，优先查 DeepAI Key、权限、余额和模型可用性。
Chatbox 报 404 Model Not Found 怎么办
404 常见原因有两个：URL 错或模型 ID 错。
先检查 Base URL：
https://api.deepai.wang/v1再检查模型 ID：
- 是否把展示名当成模型 ID；
- 是否大小写写错；
- 是否填了当前 Key 没权限的模型；
- 是否选择了 Chatbox 里旧的模型配置；
- 是否把
/chat/completions填进了 Base URL。
如果你刚修改过模型，建议重启 Chatbox 或重新打开对话，避免客户端仍在使用旧配置。
Chatbox 连接失败或超时怎么办
连接失败不一定是 API Key 问题，也可能是网络或代理问题。
可以按下面顺序查：
1. 浏览器能否访问 https://api.deepai.wang/v1； 2. curl 是否能发起请求； 3. 系统代理是否影响 Chatbox； 4. Chatbox 是否单独设置了代理； 5. 本地防火墙或公司网络是否拦截； 6. DNS 是否异常； 7. 是否把 Base URL 写错。
如果 curl 能通但 Chatbox 不通，重点看 Chatbox 的网络代理设置。如果 curl 也不通，先解决本机网络访问问题。
Chatbox 流式输出中断怎么办
有些客户端默认开启流式输出。流式输出中断时，表现可能是回答到一半停止、一直加载、或者报 stream disconnected。
排查方向：
- 尝试关闭流式输出；
- 换一个模型测试；
- 减少单次输入长度；
- 检查代理是否中断长连接；
- 看 DeepAI 后台是否有完整调用记录；
- 用非流式 curl 对比测试。
如果非流式能通，流式不通，问题通常在客户端、代理或长连接处理上，而不是单纯的 Key 错误。
Chatbox、Cherry Studio、Open WebUI 怎么选
这几个工具都能接 OpenAI-compatible API，但使用场景不一样：
| 工具 | 更适合 |
|---|---|
| Chatbox | 简洁桌面聊天、本地会话管理 |
| Cherry Studio | 多模型管理、个人高频使用 |
| Open WebUI | 团队 Web 聊天、本地和云端模型混合 |
| Dify | 应用编排、Workflow、RAG |
| Cline | 代码 Agent、自动改代码 |
如果你只是想有一个轻量桌面聊天工具，Chatbox 很合适。如果你要管理大量模型、做模型对比，Cherry Studio 会更强。如果你要给团队用，Open WebUI 更像一个统一入口。
站内相关教程：
- https://paper.deepai.wang/openwebui-deepai-openai-compatible-api-tutorial/
- https://paper.deepai.wang/dify-deepai-openai-compatible-tutorial/
- https://paper.deepai.wang/cherry-studio-deepai-model-not-showing/
- https://paper.deepai.wang/openai-compatible-api-cherry-studio-dify-cline/
推荐配置清单
为了后续稳定使用，建议你按下面方式配置 Chatbox：
| 项目 | 推荐做法 |
|---|---|
| API Host | https://api.deepai.wang/v1 |
| API Key | 单独给 Chatbox 创建一个 Key |
| 模型 ID | 只填已验证可用的模型 |
| 流式输出 | 默认开启，异常时关闭测试 |
| 代理 | 优先使用系统稳定代理，不要多层叠加 |
| 排查方式 | curl 和 Chatbox 对照测试 |
这套配置方式可以让你快速判断问题属于哪一层：客户端配置、网络代理、DeepAI API Key，还是模型 ID。
FAQ
Chatbox 可以接 DeepAI API 中转站吗？
可以。只要 Chatbox 支持自定义 OpenAI-compatible API，就可以把 API Host / Base URL 填为 https://api.deepai.wang/v1，再填写 DeepAI API Key 和模型 ID。
API Host 和 Base URL 是一回事吗？
在多数客户端里可以近似理解为一回事，都是 API 的基础地址。配置 DeepAI 时推荐填写 https://api.deepai.wang/v1。
要不要填写 /chat/completions？
一般不要。Chatbox 通常会自动拼接接口路径。你只需要填写到 /v1。
为什么模型不显示？
可能是 Chatbox 没有自动拉取模型列表，也可能是模型 ID 没有手动添加。建议先在 DeepAI 后台确认可用模型，再手动添加一个模型 ID 测试。
Chatbox 和 Cherry Studio 哪个更适合 DeepAI？
如果你想要轻量桌面聊天，Chatbox 更简单。如果你想要更强的多模型管理和调试体验，Cherry Studio 更适合。两者都可以接 DeepAI API 中转站。
总结
Chatbox 接入 DeepAI API 中转站并不复杂，真正容易出错的地方只有三个：
- Base URL 是否填成
https://api.deepai.wang/v1； - API Key 是否正确、没有多余 Bearer 或空格；
- 模型 ID 是否和 DeepAI 后台一致。
配置成功后，Chatbox 就可以作为一个轻量桌面客户端，通过 DeepAI API 中转站统一调用多种模型。对于个人用户来说，它适合日常问答和轻量写作；对于团队来说，也可以作为统一 API 网关之外的个人使用入口。