装了 ChatBox，界面挺顺手，但一到配置就卡住：设置里那行“API Key”填什么？地址栏要不要带 /v1？模型名是 gpt-4o 还是服务商起的别名？很多人手里明明有第三方 API 的 Key，却在设置页来回试了半小时，最后放弃，回去用网页版。其实这东西只要把三样东西对上，五分钟就能跑起来。
在动手打开客户端之前，先把这几项写在记事本里：
- API Key：一串 sk- 开头的字符。
- Base URL：服务商给的接口地址，通常是 https://xxx.com/v1 这种形式。
- 模型名：比如 gpt-4o-mini、deepseek-chat。要填服务商实际支持的 ID，而不是展示名称。
ChatBox 只是一个客户端，本身不提供模型能力，它通过 OpenAI 兼容协议去请求你填的地址。所以只要服务商声称兼容 OpenAI，理论上都能接进来。
不要急着打开客户端。在终端里跑一条命令，能省掉后面一半的排错时间：
返回一段 JSON 就说明 Key 和地址都对。如果报 401，Key 错了；报 404，大概率是地址少了或多写了 /v1。这一步过了，后面纯是填表。
打开 ChatBox，在设置里找到“模型 / Model Provider”这一栏，选 OpenAI API（部分版本叫“OpenAI API 兼容”）。
- API Key 粘贴那一串 Key。
- API Host / 接口地址 填你的 Base URL。这里要注意，填 https://xxx.com/v1 就够了，不要手动拼上 /chat/completions，客户端会自己加；多写一层就会出现 404。
- 如果设置里有“自定义提供方”，也可以走这条路，效果一样。
模型字段多数版本是下拉框，但里面的列表是官方的，你的服务商不一定有。直接选“自定义”或在输入框里手打模型 ID，比如 deepseek-chat。填错名字时，请求会返回 model not found，照抄服务商文档里的那一行就行。
填完保存，新建一个对话发句“你好”。有回复就通了。
跑不通时按这个顺序查：先 curl 确认 Key，再核对地址有没有多余的路径，最后检查模型名。这三处能覆盖九成问题。另外，Key 别截图发群，也别提交到 Git 仓库；第一次接通后可以先发一条短消息验证，别一上来就跑长文档，省得扣费扣得莫名其妙。配置本身不复杂，难的是搞清楚哪一段该填什么——按上面顺序来，基本一次过。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。