ChatBox(推荐使用) - new.suxi教程

ChatGPT开源桌面应用，支持全部桌面平台。
下载链接：https://github.com/Bin-Huang/chatbox/releases
使用方法：如图在设置中填入购买的密钥，并将代理设置为https://new.suxi.ai 即可

1）准备工作（1 分钟）

你需要：

✅ 已注册并登录 SUXi.Ai： https://new.suxi.ai

✅ 你的 API Key（在 SUXi.Ai 后台生成）

✅ 已安装 Chatbox（桌面端/网页版都可以）

2）在 SUXi.Ai 获取 API Key

打开： https://new.suxi.ai

登录后进入「API Key / 密钥管理」（名称可能类似：密钥、Keys、API Keys）

点击「创建新 Key」

复制保存好（只展示一次的情况很常见）

小提示：建议给 Key 起个名字，比如：chatbox，后续好管理、好排查。

3）打开 Chatbox → 进入模型/API 配置
不同版本的 Chatbox 菜单叫法略有差异，但入口通常在：

右上角 ⚙ 设置 Settings

或侧边栏 Provider / API / Model（服务商/接口/模型）

找到类似选项：

OpenAI Compatible

OpenAI API

自定义 API（兼容 OpenAI）

（Chatbox 大多数都支持 OpenAI 兼容接口，所以用这一类入口即可。）

4）在 Chatbox 填入 SUXi.Ai 的关键信息

在 Chatbox 的 API 配置页，按下面填：

✅ Base URL（接口地址 / API Host）

填：
https://new.suxi.ai

如果 Chatbox 有要求必须以 /v1 结尾（有些版本会这样），就填：
https://new.suxi.ai/v1

✅ API Key

填你在 SUXi.Ai 复制的那串 Key（一般是 sk- 开头或类似格式）

✅ Model（模型）

在模型选择下拉框里：

若能自动拉取模型列表：直接选你要用的（比如 Claude/GPT/Gemini 等）

若不能拉取：手动输入一个你在 SUXi.Ai 可用的模型名（以你后台展示的模型名为准）

最后点击：

Save / 保存

或 Test / 测试连接（如果有）

5）开始聊天（验证是否配置成功）

回到 Chatbox 对话页面：

新建一个对话

选择刚刚配置的 Provider/模型

发送一句测试语，例如：
用一句话介绍你自己

能正常返回内容，就说明配置成功 ✅

6）常见问题排查（用户最容易卡在这）

Q1：提示 401 / Unauthorized

99% 是 API Key 填错/漏填/前后有空格

重新复制粘贴一遍（别手打）

Q2：提示 404 / Not Found

Base URL 可能需要加 /v1
👉 试试：https://new.suxi.ai/v1

Q3：提示 model not found

你填的模型名不在你账号可用范围

去 SUXi.Ai 后台「模型列表」复制准确模型名再填

Q4：能连上但回复慢/超时

换更快的模型（比如偏“fast/mini/haiku”这类）

或降低 max_tokens / 关闭流式（如果你开了流式）

7）可直接复制给用户的「极简版」

Chatbox 配置 SUXi.Ai：

Base URL：https://new.suxi.ai（不行就用 https://new.suxi.ai/v1）

API Key：填你在 SUXi.Ai 后台创建的 Key

Model：选择/填写你后台可用的模型名
保存后发一句话测试即可。