Chatbox 是轻量级 AI 客户端，支持 Windows / macOS / Linux / iOS / Android / 网页版——是全平台覆盖最全的一个。装好点几下就能用，不用写代码。

如果你只是想确认我们的接口能不能用，Chatbox 是最快的选择。

安装

到 Chatbox 官网 下载对应平台的安装包，装好打开。

⚠️ 首次启动有一个必须选对的地方

Chatbox 第一次打开会弹一个窗口，问你用哪种模式：

选项	说明
使用自己的 API Key 或本地模型	选这个
使用 Chatbox AI	不要选——这是它自己的付费服务，不走我们的接口

选错了就是白花钱——你会给 Chatbox 付费，而不是用你账户里的额度。

如果已经选错了：进 设置 → 找到模型/提供方设置，切回"使用自己的 API Key"。

配置步骤

1. 在欢迎窗口底部（或设置里）点 添加自定义提供方。
2. 在设置窗口里填：

字段	填什么
API 兼容模式	OpenAI API 兼容
名称	随便起，比如 微溪
API 域名	https://api.wxiai.com/v1
API 路径	/chat/completions（默认值，不用改）
API 密钥	sk-你的APIKey
模型	grok-4.6

3. 点 保存。

Chatbox 把「域名」和「路径」拆成了两个字段

这是它和其他客户端不一样的地方——别的客户端只让你填一个地址，它让你填两个。

	填什么
API 域名	https://api.wxiai.com/v1 ← 带 /v1
API 路径	/chat/completions ← 保持默认

拼起来就是完整的调用地址 https://api.wxiai.com/v1/chat/completions。

不要把路径写进域名里，比如填成 https://api.wxiai.com/v1/chat/completions，会拼成重复路径直接 404。

验证是否接通

保存后回到聊天界面，发一句话试试。

能正常回复 → 通了。

没通 → 先用这条命令确认 Key 和地址是对的：

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

• 这条能返回模型列表 → 问题在 Chatbox 的两个字段填法上
• 这条也报错 → 问题在 Key 或地址，跟 Chatbox 无关

常见报错

现象	原因	怎么办
404	API 域名和路径拼重复了	域名只到 /v1，路径保持 /chat/completions
401	Key 不对	重新复制，注意别带空格
回复是空的 / 没反应	域名少了 /v1	补上，填 https://api.wxiai.com/v1
提示要付费 / 余额不足	用了 Chatbox AI 模式	切回"使用自己的 API Key"
model_not_found	模型名写错	用 GET /v1/models 查到的名字

更多错误见 错误码。

手机上也能用

Chatbox 有 iOS 和 Android 版，配置方式一样。手机上填 API 域名时注意别自动补成 https:// 两次。

配好之后手机和电脑共用同一个 Key 和额度——如果担心额度被占用，可以到 https://api.wxiai.com/token 建两把 Key 分开用。

相关页

• Base URL 怎么填 —— 各软件填法对照
• 对话补全 —— Chatbox 用的就是这个接口
• Cherry Studio —— 功能更全，也推荐
• 其他客户端