很多人第一次用 ChatBox 是这样的：从服务商后台复制了一串 sk- 开头的 Key，装好客户端打开，发现只有登录按钮或者默认的模型列表，翻遍设置也没找到“填 API Key”的输入框。其实入口一直都在，只是 ChatBox 把它藏在“模型提供方”里，而且术语叫 API Host、API Path，跟服务商文档里的 Base URL、Endpoint 对不上号。搞清这几个词的对应关系，配置五分钟就能跑通。
配置之前，把下面三个信息记在记事本里，缺一个都会卡住：
- API Key：服务商后台生成的密钥，形如 sk-xxxx。
- Base URL：接口地址，比如 DeepSeek 是 https://api.deepseek.com，硅基流动是 https://api.siliconflow.cn/v1。
- 模型名称：必须和服务商文档里写的一字不差，比如 deepseek-chat、Qwen/Qwen2.5-72B-Instruct。
顺手用 curl 验一下 Key 是否有效，比在客户端里反复试错快得多：
返回正常内容，说明 Key 和地址都没问题，再去配客户端。
打开 ChatBox，点左下角设置齿轮，进入“模型”或“模型提供方”页。点“添加自定义提供方”，提供方类型选 OpenAI API 兼容（不同版本叫法略有差异，认准 OpenAI 兼容即可）。这一页会出现几个输入框：API Key、API Host、API Path、模型。名字对不上没关系，本质就是“密钥 + 地址 + 路径”。
这是最容易出错的一步。ChatBox 的 API Host 填 Base URL，API Path 保持默认的 /chat/completions，两者拼起来就是完整请求地址。如果服务商给的 Base URL 本身就带 /v1，就原样填进去，别在后面再加 /chat/completions，否则会拼成 /v1/chat/completions/chat/completions，直接 404。
模型名称按服务商文档抄，大小写和斜杠都要一致，像 Qwen/Qwen2.5-72B-Instruct 这种带斜杠的也别漏。填完点“保存”或“检查”，ChatBox 一般会发一个测试请求。回到主界面，在顶部模型下拉框里选中刚配好的模型，发一句“你好”试试。
报错对照记一下：401 是 Key 错了或没带 Bearer；404 看地址和路径拼接、模型名是否写错；400 多半是模型不支持某个参数，换模型验证。
配好之后建议把提供方起个明白的名字，比如“DeepSeek-日常”“硅基-长文本”，以后按场景切换。多个服务商就多建几个提供方，别在一个配置里改来改去。Key 存在本地客户端里，别截图发群、别提交到 Git 仓库。另外留意免费额度用完会直接返回 402 或 429，这不是配置问题，充值或换 Key 就行。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。