上周一个朋友兴冲冲下了ChatBox,打开发现只有“OpenAI API Key”一个输入框。他手里有某国内代理的Key,顺手把Key填进去,点了“Send”——等了半天没反应,日志报了一堆网络错误。发截图给我看,典型的问题:客户端默认连的都是api.openai.com,代理API的地址根本不对。类似情况我见过不少,配置其实就四个动作:拿到Key、改地址、选模型、测试。下面一步步走通,以后换API直接三分钟搞定。
你需要三样东西。第一是ChatBox桌面客户端,从官网或GitHub Releases下载,Windows/macOS/Linux各版本都有,安装完先别急着点“开始对话”。第二是你要用的第三方API信息,至少包括:API Key(通常是sk-开头的一串字符)、完整的Base URL(比如 https://api.xxx.com/v1)、以及你计划使用的模型名称(例如 gpt-3.5-turbo-0613 或 claude-2)。第三,如果API有特殊要求(比如需要自定义Header或代理),提前确认好,常见的第三方服务往往只需要改地址和Key就行。
先去第三方服务商的后台生成Key,复制下来(注意不要暴露给他人)。然后打开ChatBox,点击左下角齿轮图标进入设置。新手最常见的问题是:在设置里直接往“OpenAI API Key”框里粘贴就完事了——不,这只是第一步。你还需要往下看。
在设置页里往下翻,找到“Advanced”或“自定义API地址”(不同版本翻译略有差异,但图标类似一个扳手)。默认值是 https://api.openai.com/v1,你需要换成你手里API地址。举个例子,如果你用的是某国内代理,地址可能是 https://api.xxxx.com/v1。直接覆盖输入,注意末尾要带 /v1(大部分兼容OpenAI格式的服务都需要)。如果你用的是本地Ollama部署的模型,地址就是 http://localhost:11434/v1。
配置截图参考(没有截图,文字说明):
`
API Key: sk-xxxxxxxxxxxxx
Base URL: https://api.your-provider.com/v1
`
地址改完后,回到顶部,在“Model”下拉框里输入或选择模型名称。注意:这个下拉框不会自动获取服务端列表,你需要手动输入正确的模型名。比如某代理支持 gpt-4-32k,就打出这个字符串。如果不知道有哪些模型,去第三方API的文档里查,或者先填一个通用的比如 gpt-3.5-turbo 测试。把设置界面右上角的“Save”点一下。
关闭设置,在聊天输入框打一句简单的“Hello, world”回车。如果一切正常,你会看到AI开始打字。如果报错,常见情况:模型名写错(大小写敏感)、地址末尾缺少 /v1、Key过期或权限不足、网络不通(比如本地代理需要配置系统网络代理)。可以点聊天框右侧的小扳手图标查看请求日志,看请求实际发到了哪个地址,以及返回的错误信息是什么。
一旦配置成功,以后换其他第三方API只需要重复两步:复制新Key、改地址和模型名。建议把常用的几个API地址记下来或做一个笔记,避免每次翻文档。另外,如果使用收费API,记得在提供商那边设置月度限额,防止不小心烧光预算。ChatBox这类客户端本质就是一个包装好的HTTP请求工具,理解了背后的逻辑,配置就变成一件很简单的事。
如果你也想试试一个Key调多个模型的方便,可以看看充站——¥50起步,额度永久有效,用支付宝/微信就能付款。