很多人装完 ChatBox 第一件事，是打开设置想接自己的 API，然后在“API 域名”那一栏停住了——到底填 https://xxx.com 还是 https://xxx.com/v1？填错一个后缀，客户端就报 404，界面上只有一句“请求失败”，看不出是地址问题还是 Key 问题。下面按拿到 Key 到能正常对话的顺序走一遍，重点标出几个容易踩的坑。
- ChatBox 客户端，官网下载对应系统版本，装好先别急着登录。
- 一个兼容 OpenAI 接口格式的服务：第三方中转、公司内网网关、或者本地跑的 Ollama 都行。只要它支持 /v1/chat/completions 这条路。
- 三样信息：API Key、API 地址（Base URL）、模型名称。少一样都配不成，先去服务商控制台把它们抄下来。
服务商文档里常见两种写法：https://api.example.com 和 https://api.example.com/v1/chat/completions。ChatBox 要的是前者加上版本号，也就是填到 /v1 为止：
拿不准就直接在浏览器打开 地址/v1/models，能返回 JSON 列表说明地址对了。这一步能省掉后面一半的排错时间。
打开 ChatBox 的「设置」→「模型」，在 AI 服务提供方里选 OpenAI API 兼容（有的版本叫“自定义提供方”）。然后依次填：
| 字段 | 填什么 |
| --- | --- |
| API Key | 服务商给的 sk- 开头那串 |
| API 域名 | 上一步确认的 /v1 地址 |
| 模型 | 手填模型名，比如 gpt-4o-mini、deepseek-chat |
模型那一栏常常是下拉框里没有你要的选项，别被误导，多数版本支持手动输入。模型名必须和服务商文档完全一致，大小写、连字符都不能差。
保存后新建对话，发一句“你好”。正常返回就通了。如果失败，按状态码判断：401 是 Key 错或没余额；404 基本都是地址多写或少写了 /v1；400 里带 model 字样，说明模型名不对。这三类问题占了新手配置失败的绝大多数。
给 ChatBox 单独申请一个 Key，别复用生产环境的主 Key，再在服务商那边设个额度上限，泄露了也不至于太难看。如果接的是本地 Ollama，地址填 http://localhost:11434/v1，Key 随便填个 ollama 即可。换服务商时只需改地址和模型名，历史对话不受影响。配置这类客户端，卡住的从来不是操作步骤，而是那串地址到底该写到哪——把这点搞明白，剩下的都是填空。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。