装好 ChatBox，打开发现只能登录官方账号，想用自己的 API Key 接别的模型，结果在设置里填了半天，一直弹 401 或者 404，模型列表还是空的。多数情况不是 Key 有问题，而是接口地址和模型名没对上。这里按顺序走一遍。
- ChatBox 桌面版，Windows / macOS / Linux 都有，版本尽量新一点
- 一个可用的 API Key，以及服务商给的接口地址（后台通常叫 Base URL）
- 要用的模型 ID，比如 gpt-4o-mini、deepseek-chat，注意是 ID 不是界面上显示的中文名字
这三个信息一般在同一个控制台页面里，Key 旁边就是接口地址。
在服务商后台创建 Key，通常是 sk- 开头的一长串。同一页面上会写接口地址，形如 https://api.example.com/v1。复制的时候检查一下首尾有没有多余空格，以及 /v1 有没有被漏掉——这两处是新手最常踩的坑。
打开 ChatBox，左下角齿轮进设置，找到「模型」选项卡。在提供商里选 OpenAI API 兼容（有的版本叫 Custom OpenAI、自定义 OpenAI），会露出几个输入框：
API Host 只填到 /v1 为止，别填成 /v1/chat/completions，完整的请求路径客户端会自己拼。填多了直接 404。
模型这一栏如果是下拉框，就点「添加」手动输入模型 ID 再保存。名字必须和服务商的 ID 一字不差，大小写也算。这里填错的表现是接口通了但报 model not found，看着像 Key 失效，其实只是名字不匹配。
新建一个对话，发句「你好」。看报错就能定位问题：
- 401：Key 错了，或者填完没点保存 - 404：API Host 多了/少了路径，或模型名不对 - 403：账号余额不足或没权限 - 能正常出字，说明配通了
先用便宜的小模型跑通链路，确认没问题再换大模型，省得排查时分不清是配置错还是额度问题。Key 别贴进截图和公开仓库，泄露了及时去后台吊销重发。不同版本 ChatBox 的菜单叫法有差异，实在找不到，在设置里搜「OpenAI」基本能定位到那个选项。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。