ChatBox配置第三方API教程

📅 2026-07-29 · 分类:教程

开头:一个真实痛点场景

你兴冲冲下载了 ChatBox,想用它来跟大模型聊天。点开设置发现默认只写了 OpenAI 的 API Key 和地址。但你用的是国内某个厂商的 API,或者本地跑了一个 Ollama 服务。试着手动改一下地址,发现怎么都连不上,报错“模型不存在”或者“地址无效”。更糟的是,你在网上搜了一圈,教程不是太老就是语焉不详,最后只能继续用官方的贵价 API。其实 ChatBox 的兼容性做得不错,只是配置方式藏得比较深。这篇文章就手把手带你走完流程,让你五秒钟之内用上自己的模型。

准备工作:需要什么

先备好三样东西。第一是你的第三方 API Key,比如从硅基流动、DeepSeek、OpenRouter 或者本地部署的 vllm 服务获取的密钥。第二是这个 API 的完整请求地址——通常是形如 https://api.example.com/v1/chat/completions 的链接(注意末尾不要带 /)。第三是你想用的模型名,比如 gpt-3.5-turbo 或者 deepseek-chat。如果你用本地 Ollama,API 地址一般是 http://localhost:11434/v1,模型名可以是 llama3 之类的。确保服务端已经在运行,并且你的网络能访问这个地址。准备就绪就可以打开 ChatBox。

具体步骤:拿到 Key → 填入设置 → 改 API 地址 → 选模型

第一步,复制你的 API Key。在 ChatBox 主界面左下角点击齿轮图标进入设置,找到“API Key”输入框,直接粘贴进去。注意有些第三方平台生成的 Key 前面会带 sk- 前缀,保留原样即可。

第二步,修改 API 地址。在设置页里有一个“API 地址”输入框(英文版是 API Host)。默认是 https://api.openai.com,你需要把它改成你用的第三方地址。比如用硅基流动:https://api.siliconflow.cn。注意地址末尾不加 /v1,ChatBox 会自动拼接补全。如果地址里包含了路径,比如 https://example.com/my-api/v1,那就填完整的,ChatBox 会把 completions 追加在后面。改完后保存设置。

第三步,选择模型。退出设置回到聊天界面,点击左上角的模型选择器(通常显示当前模型名),在下拉框里输入你想要的模型名,比如 gpt-3.5-turbo 或者 qwen2.5:7b。注意模型名必须和第三方平台返回的名称完全一致,大小写敏感。如果你不确定,可以先去第三方平台的控制台查一下文档,或者发一个简单的 curl 请求验证。

配置完毕,随便发一条消息测试。如果报错“404”或“模型不存在”,检查 API 地址是否正确,或者模型名是否写错。如果报“401”,说明 API Key 有问题。如果一切正常,恭喜你,ChatBox 已经连上你自己的模型了。

结尾:总结+建议

整个过程概括下来就是:搞到 Key,填地址,写模型名。新手最容易踩的坑有两个:一是地址末尾多加了 /v1/chat/completions 导致路径重复,二是模型名拼写错误。建议先把地址粘到浏览器里访问一下,看能不能返回一个 JSON 响应(通常是一个错误信息,但说明网络通)。另外,如果服务端要求添加自定义请求头(比如认证方式不是 Bearer),ChatBox 可能不支持,你可以考虑用 One API 这类中间件做适配。总的来说,这个流程对大多数第三方 API 都有效,熟练后一分钟就能搞定,性价比比官方 API 高得多。

如果你也想试试一个Key调多个模型的方便,可以看看充站——¥50起步,额度永久有效,用支付宝/微信就能付款。

← 返回文章列表