手里有一个第三方 API Key——可能是中转站买的，可能是公司内部网关发的，也可能是自己搭的 Ollama。想把 ChatBox 用起来，装完之后打开设置，一堆「模型提供方」「API Host」「自定义模型」的输入框，不知道先填哪个、填错会不会报错。下面按顺序走一遍，照着填就行。
需要三样东西：一个 API Key、一个接口地址（Base URL）、一个模型名称。后两个经常被忽略，但缺一个都跑不起来。
先确认你的服务是 OpenAI 兼容接口。判断方法很简单，用 curl 打一下：
返回一串 JSON 里有 data 数组，说明格式没问题。返回 404 或一堆 HTML，多半是地址写错了，或者这个服务不兼容 OpenAI 协议。
打开 ChatBox，点左下角齿轮进设置，找到「模型」或「AI 服务提供商」（不同版本叫法略有差异）。
不要选那些预设好的官方服务商，往下找 「添加自定义提供方」，API 模式选 OpenAI API 兼容。
- API Host：填你的接口地址，一般以 /v1 结尾，比如 https://api.example.com/v1。注意别多写 /chat/completions，客户端会自己拼。
- API Key：粘贴你的 Key，前后不要带空格。
在同一页面往下拉，找到「模型」列表，点添加，手动输入模型 ID。这个 ID 必须和服务商给的完全一致，比如 gpt-4o、deepseek-chat、qwen-plus，多一个空格都会报「model not found」。
不确定叫什么的话，用上面那条 curl 的返回值，data 里每个对象的 id 字段就是可用模型名，直接抄。
点保存，回到主界面，在对话框顶部或输入框旁边切换到你刚加的模型，随便发一句「你好」。
正常几秒内出结果。报错的话按这个顺序排查：
- 401 → Key 错了或过期
- 404 → 地址路径不对，重点检查有没有 /v1
- model not found → 模型名拼错
- 一直转圈 → 网络不通，试试关掉代理或换一个
配置本身不复杂，坑基本集中在这三处：地址带不带 /v1、模型名对不对得上、Key 有没有复制全。建议第一次配完先发一句最简单的测试，别急着调参数。
另外，Key 存在本地配置文件里，别把配置截图发到群里；如果是共享电脑，用完记得清掉。本地跑 Ollama 的话地址填 http://127.0.0.1:11434/v1，模型写 llama3 这类实际拉过的名字就行。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。