刚拿到ChatBox客户端，想用本地大模型或者换一个更便宜的中转API，结果点开设置就懵了。默认填的是OpenAI的地址和模型，可你手头只有一串第三方的Key，连地址是啥都不清楚。问群里，有人说“改base_url”，有人说“选自定义模型”，最后试了几次要么报401，要么返回空。这种时候最烦人——客户端本身是好东西，但配置环节就像一堵墙，绕过它才能聊天。
动手之前，先把东西备齐。首先是ChatBox桌面客户端，官网下载对应系统版本就行，安装后别急着点“开始聊天”。其次，必须有一个第三方API的Key，比如从API2D、AiHubMix、或者自己部署的OneAPI获取的。拿到Key的同时，记下完整的API端点地址，通常长这样：https://api.xxx.com/v1 或 https://xxx.com/v1/chat/completions。不同服务商给的地址格式可能略有不同，但核心是URL路径里要有 /v1。最后，知道自己想用哪个模型名，比如 gpt-3.5-turbo、claude-3-haiku 或者国产的 qwen-turbo。这三样东西（Key、地址、模型名）一个都不能少，缺一个你就没法往下走。
第一步：打开设置，找到模型配置入口。 点击ChatBox左下角的齿轮图标，进入设置页面。左侧导航栏找到“模型”分类，你会看到当前默认的“OpenAI”或者“GPT-3.5”等选项。新手最容易犯的错就是直接在默认配置里改Key，却忘了改地址——你必须新建一个自定义配置。点击“添加自定义模型”或“管理模型”按钮（不同版本文字略有差异），选择“OpenAI兼容”或“其他”，因为大多数第三方API都兼容OpenAI的接口格式。
第二步：填入Key和API地址。
在弹出的表单里，把拿到的API Key粘贴到“API密钥”或“Key”字段。然后在“API地址”或“Base URL”里填完整地址。注意：如果服务商给的地址是 https://api.xxx.com，后面要加上 /v1 或者直接加上 /v1/chat/completions？ChatBox会自动拼接路径，所以你只需填根地址，比如 https://api.xxx.com。但有些老版本需要全路径，保险做法是先试根地址，如果报404再改全路径。以下是一个示例配置：
第三步：选择模型并测试。
保存配置后，回到主界面，点击左上角的模型下拉菜单，应该能看到刚添加的模型名。选中它，在输入框随便打一句“Hello”，按回车。如果正常返回回答，恭喜你配置成功。如果报错，最常见的三种情况：
- 401：Key无效或过期，检查Key前后有没有多余空格。
- 404：API地址不对，把前面提到的 /v1 加一加或去一改。
- 模型不存在：模型名拼写错误，或者该服务商不支持你写的模型，换成列表里有的名字。
第四步（可选）：调整请求参数。 有些第三方服务对超时时间或最大Token有限制。在模型配置界面，可以设置“最大长度”或“超时秒数”。新手建议先用默认值，遇到连接超时再调大到60秒以上。另外，如果你用的服务需要特定请求头（比如Authorization格式特别），一般在ChatBox里不需要额外处理，兼容OpenAI的通常都通了。
配置第三方API这件事，本质就是三个变量：Key、地址、模型名。弄对了就能聊，弄错了就报错，没什么玄学。建议新手先找一款免费或低价的服务商做测试，比如用OneAPI自建中转，或者用国内几个常见的聚合API，成本极低。一旦配好，ChatBox就能变成你私人的大模型工作台，换模型就跟换输入法一样方便。最后提醒一句：Key别截图晒群里，API地址别随便改，保持顺手就行。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。