ChatBox 桌面版默认走官方通道,额度用完或者想换成更便宜的第三方中转,很多人卡在第一步:翻遍设置也找不到填 Key 的地方。更烦的是,随便填完点发送,弹出来一个 401 或者 404,连报错原因都看不出来。其实配置逻辑很简单,就是把三个东西对上:Key、地址、模型名。下面按顺序走一遍。
- ChatBox 桌面版:从 GitHub Releases 或官网下载,别用网页版——网页版受浏览器跨域限制,很多中转地址会直接失败。
- 一个 API Key:第三方服务商后台生成的,通常以 sk- 开头。
- 服务商的 Base URL 和模型 ID:在服务商的文档或后台能看到,比如 https://api.example.com 和 deepseek-chat。
这三样缺一不可。拿到后先放在记事本里,别一边配置一边来回切网页复制。
打开 设置 → 模型,在「API 提供者」里选 OpenAI API(大多数第三方中转都兼容 OpenAI 格式)。如果版本较新,也可以选「添加自定义提供者」,自己起个名字。
关键的两个字段:
注意 API 域名不要带 /v1。ChatBox 会自己在后面拼 /v1/chat/completions。如果你把 /v1 也写进去,变成 /v1/v1/chat/completions,服务端直接返回 404——这是新手最常见的坑。
在模型列表里点「获取模型」,能连上的话会自动拉出一串 ID,勾选你买了额度的那个。如果拉不出来(有些中转不开放模型列表接口),就手动添加:
名称必须和服务商文档里写的完全一致,大小写都不能差。填成 DeepSeek-Chat 一样会报 model not found。
新建一个对话,随便问一句。如果失败,按状态码判断:
- 401 → Key 错了、复制时带了空格,或者额度用完了。
- 404 → 地址写错,八成是 /v1 重复,或者域名少了个 s。
- 403 → Key 有效但没权限用这个模型。
- 超时 → 服务商被墙或临时挂了,换个地址试试。
改完设置记得点保存,ChatBox 有些版本不点保存就直接新开对话,改的参数没生效。
模型名手动填比自动获取稳,尤其是中转服务。另外 Key 等同于密码,别贴进截图或者聊天记录里发出去,泄露了只能去后台吊销重生成。
配好一次之后,换服务商也只是改地址和 Key 两行,几分钟的事。真正花时间的从来不是配置,是找到那个靠谱的中转。
如果你也想试试一个Key调多个模型的方便,可以看看充站——¥50起步,额度永久有效,用支付宝/微信就能付款。