ChatBox

ChatBox 是一个跨平台 AI 聊天客户端，覆盖 Windows / macOS / Linux 桌面版与 iOS / Android 移动版，并提供网页版。它内置 OpenAI 自定义提供商，可以直接接入 Sakrylle。

• 官网：https://chatboxai.app
• 仓库：https://github.com/chatboxai/chatbox
• 网页版：https://web.chatboxai.app

前置准备

1. 在 ChatBox 官网下载并安装对应平台客户端，或直接使用网页版
2. 在 Sakrylle 控制台 创建一个 API Key

配置步骤

ChatBox 支持的 Sakrylle 接入方式是 OpenAI 兼容：

1. 打开 ChatBox，点击左下角 设置（齿轮图标）
2. 进入 模型 标签
3. 模型提供方（Model Provider）下拉列表选择 OpenAI API 或 OpenAI Custom
4. 配置区填：
   • API 密钥（API Key）：你的 Sakrylle Key
   • API 域名（API Host）：https://api.sakrylle.com
   • 如果界面有"API 路径"或"API Path"字段，保留默认 /v1/chat/completions
   • 如果只有一个"API Base URL"字段，填 https://api.sakrylle.com/v1
5. 模型 字段：
   • 优先选择 ChatBox 下拉里的 gpt-5.6-sol，没有就点击 自定义模型 或 添加模型，手动输入：
     • gpt-5.6-sol
     • gpt-5.4
     • gpt-5.5
6. 保存设置，回到主界面新建对话即可

ChatBox 不同版本的字段命名略有差异（"API Host" / "API 域名" / "API Base URL"）。核心原则是：只要让最终请求打到 https://api.sakrylle.com/v1/chat/completions 就对了，按当前 UI 里的字段含义把 host 与 path 拆好。

常见问题

• 模型列表为空：ChatBox 不会自动从 /v1/models 拉列表，必须手动加自定义模型名
• 401 invalid_api_key：检查 Key 是否复制完整、是否还启用、是否被删
• 网络错误 / Connection failed：检查 API 域名 / Base URL 拼写；如果开启了系统代理或 VPN，关掉再试
• 流式不工作 / 一直转圈：设置里关掉"流式响应"先验证非流式能通，再排查代理 / 防火墙
• 手机端 Cellular 下连不上：尝试切到 Wi-Fi；某些移动网络运营商会拦截海外域名