Chatbox - 跨平台 AI 客户端

选择 OpenAI API 兼容

cnAPI 在 Chatbox 中应使用 OpenAI API 兼容 模式。API 主机和 API 路径是两个 独立字段，不要在两处重复填写 /v1/chat/completions。

Chatbox 是支持桌面端、移动端和网页端的 AI 客户端，可以添加 OpenAI、Claude、Gemini 以及自定义兼容服务商。

• 官网：https://chatboxai.app
• 官方文档：https://docs.chatboxai.app
• GitHub：https://github.com/chatboxai/chatbox

使用前准备

1. 在 cnAPI 控制台创建 API Key。
2. 复制至少一个当前账户可用的准确模型 ID。
3. 安装或更新 Chatbox。

配置参数

添加 cnAPI 服务商

1. 打开 Chatbox，进入 设置 → 模型提供方。
2. 滚动到列表底部，点击 添加。

3. 名称填写 cnAPI，API 模式选择 OpenAI API 兼容。

4. 在 API 密钥 中粘贴自己的 cnAPI API Key。

5. API 主机 填写 https://cnapi.vip/v1。

6. API 路径 留空。Chatbox 会使用 /chat/completions，最终请求地址为 https://cnapi.vip/v1/chat/completions。

7. 在模型区域点击 新建，填入准确的模型 ID。

8. 只有确认模型支持时，才勾选视觉、推理、工具使用等能力；上下文窗口和最大输出也应 按实际模型能力填写。

9. 保存服务商，点击 检查。出现“连接成功”后返回聊天页面。

下图以 Chatbox 官方配置页为底图，仅将服务商名称、API 主机和模型 ID 替换为 cnAPI 示例值；API Key 保持遮盖。实际使用时请填写 cnAPI 模型列表返回的准确 ID。

10. 新建会话，在底部模型选择器中选择 cnAPI 模型并开始使用。

验证是否成功

1. 服务商页面点击 检查，确认显示“连接成功”。
2. 选择已添加的模型发送一条测试消息。
3. 在 cnAPI 控制台使用日志中核对请求时间和模型 ID。

常见问题

请求地址出现重复路径

推荐保持以下组合：

API 主机：https://cnapi.vip/v1
API 路径：留空

不要把完整的 https://cnapi.vip/v1/chat/completions 同时放入主机和路径字段。

点击获取后没有模型

使用 新建 手动添加准确模型 ID。模型是否能自动获取取决于当前版本和模型列表接口， 手动添加后仍应执行一次“检查”和真实对话。

应该选择 OpenAI Responses 吗

普通兼容聊天选择 OpenAI API 兼容。只有 cnAPI 对应模型和渠道明确支持 Responses API 时，才使用 Responses 类型。

能力选项应该全部勾选吗

不应该。视觉、推理、工具使用等勾选项会改变 Chatbox 的请求方式，必须与模型真实能力 一致。模型不支持时强行开启会导致参数错误。

返回 401 或模型不存在

401 通常是 API Key 无效；模型不存在则检查模型 ID 的大小写、连字符和账户权限。不要 把 API Key 放入截图或反馈正文。

官方依据

• Chatbox 模型配置教程
• Chatbox 当前服务商设置页源码
• OpenAI API Host 与 Path 处理源码
• Chatbox 官方仓库

[

LibreChat - 可自托管多模型对话平台

通过 librechat.yaml 将 LibreChat 接入 cnAPI。

](/zh/docs/apps/librechat)[

AstrBot - Agent 聊天机器人

AstrBot 配置教程 — 将开源 Agent 聊天机器人平台对接 cnAPI，为 QQ、飞书、钉钉、企业微信等即时通讯注入 AI 能力。

](/zh/docs/apps/astrbot)