Chatbox API 配置:自定义提供商四步接入第三方模型

先给结论:四步配好 Chatbox 自定义提供商

Chatbox 是覆盖 Windows、macOS、Linux、iOS、Android 的轻量 AI 客户端,下载安装包即用,不需要 Docker,也不碰命令行。它的自定义提供方入口就是为第三方 OpenAI 兼容接口准备的,kkaiapi 正是这类接口,面向中文开发者的模型中转,所以照着下面这份参数清单抄一遍就能跑通。

• 第一步:打开 Chatbox,进入 设置 > 模型提供方,点击 添加自定义提供方,API 模式选 OpenAI API 兼容
• 第二步:API Host 填 https://api.kkaiapi.com/v1,Chatbox 会自动拼接 /chat/completions;如果你的版本有单独的 API 路径输入框,则填 /v1/chat/completions
• 第三步:API 密钥粘贴 kkaiapi 控制台生成的 sk- 开头的 Key,还没有就先到充值页开通再建一个
• 第四步:在模型一栏手动输入模型 ID,例如 deepseek-v4-flash,点添加并保存,回到聊天窗口顶部切换到新模型即可开聊

名称:      kkaiapi(随意,仅用于显示)
API 模式:  OpenAI API 兼容
API Host:  https://api.kkaiapi.com/v1
API Key:   sk-xxxxxxxx(kkaiapi 控制台生成)
模型:      deepseek-v4-flash(手动输入后点添加)

模型 ID 填法:一个字符都不能错

Chatbox 面对第三方提供商时不一定能自动拉取模型列表,部分版本有获取按钮可以先点一下,拉不到就手动添加。手动添加时模型 ID 必须与服务端完全一致:全小写,注意连字符和点号的区别。常用 ID 如下:deepseek-v4-flash、deepseek-v4-pro、glm-5、kimi-k2.6、claude-sonnet-4-6、claude-opus-4-7、gpt-5.5、grok-4.5。其中 claude-sonnet-4-6 的版本号用连字符,kimi-k2.6 用点号,抄错的典型报错是 model not found。 拿不准配置对不对时,先用 curl 在终端验证一次接口,把客户端因素排除掉:

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "你好"}]}'

手机端怎么同步:同一个 Key,多端共用

Chatbox 的 iOS 和 Android 版入口与桌面端一致,同样在 设置 > 模型提供方 里添加自定义提供方。要注意配置保存在设备本地,免费版没有跨设备云同步,所以手机端需要把相同参数再填一遍。好在参数一共就三项,Host、Key、模型 ID,一分钟填完。 同一个 API Key 可以在任意多台设备上同时使用,用量在 kkaiapi 控制台合并计费。如果想分开统计手机和电脑各自花了多少,在控制台给手机单独建一个 Key 即可,日志页支持按 Key 筛选。Key 忘了随时回控制台查看,不需要抄在备忘录里。

Chatbox 适合谁:轻量客户端的定位

Chatbox 的定位是即开即用的个人聊天窗口:安装包直装、界面干净、全平台覆盖,发图片和文件也没问题。它刻意不做重功能,没有插件市场,知识库能力也远弱于竞品。这既是缺点也是优点,取决于你要什么。 如果你只想要一个稳定好用的多模型聊天工具,手机电脑都能开,Chatbox 是三者里上手最快的。如果你需要本地知识库、多模型同屏对比或 MCP 工具调用,桌面端选 Cherry Studio 更合适;如果你想部署一个团队共享的网页入口,带插件和多用户,那是 LobeChat 的场景。

常见问题