你可能遇到过这种情况:ChatBox 装好了,但用官方 API 又贵又容易遇到额度限制,翻来覆去找不到第三方接口在哪配。明明拿到了一个免费的 API Key,界面里却不知道填哪,还担心填错了会用不了。别急,这个配置逻辑其实很简单,核心就五步:拿 Key、填地址、选模型、保存、开聊。
准备工作
你需要两样东西:一是下载好的 ChatBox 桌面客户端(Windows / macOS / Linux 都行),二是一个有效的第三方 API Key 和对应的 API 地址。这里的“第三方”可以是自己搭建的 OneAPI 中转服务、私有部署的本地模型(比如 ollama 的 OpenAI 兼容接口),或是其他厂商提供的 OpenAI 兼容 API。关键点是:它必须支持 /v1/chat/completions 这个接口。拿到 Key 和域名(例如 http://localhost:11434/v1)就够了,不需要额外工具。
步骤 1:进入模型设置对话框 打开 ChatBox,点击左下角或右上角的齿轮图标进入设置页。在“模型”或“AI 提供商”分类下,你会看到一个下拉选择框,默认可能是“OpenAI”。新手容易卡在这一步:以为只有官方选项。别担心,往下翻,找到 “添加自定义模型” 或 “OpenAI 兼容” 这一项。不同版本名称稍有差别,但核心逻辑一样——选择第三方接入点。
步骤 2:填入 API Key 和 API 地址
选中“OpenAI 兼容”后,界面会出现两个输入框:API Key 和 API 地址。Key 填你拿到的字符串(直接粘贴,注意不要有多余空格)。API 地址要填完整的 /v1 路径,比如 http://192.168.1.100:8080/v1 或 https://api.xxx.com/v1。有些第三方会要求把 Key 填在地址里(如 https://key@localhost:8080/v1),但绝大多数情况分离填写更规范。填完别急着下一步,先检查地址末尾有没有多余的斜杠。
步骤 3:指定模型名称
大部分第三方 API 需要你手动输入模型 ID,比如 gpt-3.5-turbo、gpt-4 或自部署的 Qwen2.5-7B。ChatBox 设置里通常有个“模型名称”输入框,留空的话客户端会自动拉取服务端的模型列表,但很多第三方不提供列表接口,所以手动填最保险。你可以在服务端文档里确认模型名称,或者随便填一个,测试时报错再改。注意大小写要完全一致。
步骤 4:保存并测试 点击保存或应用,返回对话界面。在模型选择下拉框里应该能看到你刚配置的第三方选项。选它,输入第一条消息,比如“Hi”,点发送。如果返回正常回复,说明配置成功;如果报 404 或 401,回去检查地址和 Key。403 经常是 Key 过期或 IP 白名单未设置。一个小技巧:先拿 curl 测试接口是否连通,能省很多排查时间。
总结与建议
配置第三方 API 本质上就是把官方接口换成你自己的端点,ChatBox 设计上已经考虑到了这种需求。新手容易犯的两个错误:一是忘记加 /v1 路径,二是模型名称填错。建议第一次先用一个稳定免费的第三方(比如本地 ollama 的兼容接口)跑通流程,再切到收费服务。另外,如果配置完发现模型下拉菜单没有出现,可以退出 ChatBox 重新打开,或手动刷新设置页面的模型列表。搞定这一步,你就能自由切换各种廉价或私有模型了,省下的钱和时间都实打实。
如果你也想试试一个Key调多个模型的方便,可以看看充站——¥50起步,额度永久有效,用支付宝/微信就能付款。