装好 ChatBox，把买来的 API Key 粘进去，结果对话框一直转圈，或者弹个 401、404。这种情况多半不是 Key 有问题，是 API 地址没对。ChatBox 默认连官方端点，你用中转服务或本地部署的模型，地址不换必然失败。下面这套流程照着走，五分钟能跑通。
需要四样东西：ChatBox 桌面客户端（去官网下最新版，老版本配置项位置不一样）、一个可用的 API Key、服务商给的 API 地址（一般形如 https://xxx.com/v1）、想用的模型 ID（比如 gpt-4o-mini、deepseek-chat，必须和文档一字不差）。
别一上来就在客户端里试。开个终端跑一条 curl，十秒钟能排除一半问题：
返回带 choices 的 JSON 就说明 Key 和地址都对。报 401 是 Key 错，404 通常是地址少了或多了 /v1，提示 model not found 就是模型名写错。这一步过了再进客户端，能省掉大量瞎猜。
打开设置 → 模型提供方（部分版本叫“AI 模型”），点“添加自定义提供方”，API 模式选 OpenAI API 兼容。中转服务和绝大多数国产模型都走这个协议，选它准没错。
然后填三项：API Key 直接粘贴；API Host 填上一步 curl 用的地址，注意只填到 /v1 为止，ChatBox 会自己补后面的路径，多填一段就会拼出 /v1/chat/completions/chat/completions 这种重复路径；模型名手动输入，下拉列表里没有就自己敲。
保存，回到对话页，在模型下拉里选中刚配的那个，发一句“你好”。能正常回复就算通了。
还报错的话回头核对三点：地址末尾有没有多余斜杠、模型名大小写对不对、Key 前后有没有带上空格。这几个占了新手踩坑的绝大多数。
配置的核心就三件事：地址填到 /v1、模型名抄准确、先 curl 后进客户端。建议把常用的一两个提供方都配好，ChatBox 支持对话时随时切换——写代码用便宜快的模型，长文档分析再换大的，成本能压下来不少。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。