Chatbox 接入中转站：添加自定义的模型提供方，电脑和手机都能用

Chatbox 是一个 AI 对话客户端，Windows、macOS、Linux、iOS、Android 和网页都能用。它有自带的模型服务，也可以填自己的 API。接中转站是后一种用法，官方文档叫“配置自定义 AI 提供方”：

设置 → 模型提供方，点底部的添加；
填名称，选 API 类型；
填 API 密钥和 API 主机；
添加至少一个模型；
保存后点检查，提示连接成功就可以用了。

如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：从中转站拿到三样东西

需要什么	说明
接口地址	以及它是哪一种接口：OpenAI 兼容的，还是 Anthropic 原生的
模型名	中转站模型页上写的名字，一字不差
API key	在中转站的控制台创建，多数站只显示一次

1添加提供方，选 API 类型

打开 Chatbox，点侧边栏的设置，进入 模型提供方。列表里没有你要的，就点底部的添加。

填一个名称，再按接口的类型选 API 类型。官方文档的说明是按提供方的 API 类型来选，比如 GPT 模型选“OpenAI API 兼容”，Gemini 模型选“Google Gemini 兼容”。

接中转站时常用的是下面几种。后两种见于中转站一方的接入文档，官方的这页文档里没有逐个列出：

API 类型	什么时候选
OpenAI API 兼容	中转站提供 OpenAI 兼容接口。最通用
OpenAI Responses API 兼容	模型要走 OpenAI 的 Responses 接口时
Anthropic Claude API 兼容	用 Claude，中转站提供 Anthropic 原生接口时

拿不准就选第一种。

2填密钥、主机和路径

Chatbox 把接口地址拆成了两段：

项目	填什么
API 密钥	中转站的 key
API 主机	中转站的地址
API 路径	官方文档说一般可以不填，默认是 `/v1/chat/completions`，具体参考提供方的信息

也就是说，按默认的设置，最后请求的地址是“主机”加上 /v1/chat/completions。官方文档里导入配置的例子，主机写的是 https://api.openai.com/，后面不带 /v1。

所以中转站的 OpenAI 兼容接口如果是标准的 https://你的中转站地址/v1/chat/completions，主机填 https://你的中转站地址，路径留空。路径不标准时，把实际的路径填到“API 路径”里。

以酷站AI 为例：它的文档写的 OpenAI 兼容接口是 https://api.koozhan.com/v1/chat/completions，按上面的规则，主机填 https://api.koozhan.com，路径留空。

也有中转站在自己的接入文档里直接给出 Chatbox 里要填的写法，和上面的拆法不一样。有这种说明时照它写，然后用第四步的“检查”确认。

3添加模型，勾选能力

官方文档要求添加至少一个模型，并说明模型的能力是可选的：不配置的话，这个模型被当作纯文本模型。

两种加法：

按中转站一方的接入文档，填好密钥和主机后点获取，可以自动拉取中转站的模型列表，再点 + 把要用的加进来；
手动填模型 ID，照中转站的模型页写。

能力有三项，决定 Chatbox 怎么调用这个模型：

能力	说明
视觉	模型能看图。不勾的话发不了图片
推理	模型有思考过程
工具使用	模型能调用工具。联网搜索、MCP 这类功能要靠它

按模型实际支持的来勾。勾了模型并不支持的能力，用到的时候请求可能出错。

4检查

保存后点检查，提示连接成功就说明配好了。按中转站一方的接入文档，检查时会分别发文本、图片和工具调用三种请求，都显示对勾才算全部通过。

回到首页新建对话，在模型选择器里选这个提供方下面的模型。

手机上怎么配

iOS 和 Android 的步骤和电脑上基本相同：设置里添加模型提供方，填名称、API 类型、密钥和主机，保存后填模型 ID、勾选能力，再测试连接。

手机上没法方便地复制长串的 key 时，可以先在电脑上配好并验证，再把同样的内容填到手机上。

一键导入配置：只从信得过的地方导入

官方文档说明，从 1.15.1 版起，Chatbox 支持导入 JSON 格式的提供方配置，有些服务商会在官网上给出配置，复制后一键导入，或者点一个 chatbox:// 开头的链接直接导入到客户端。

导入的配置里包含接口的主机地址，还可以带上 key 和默认的模型列表。方便是方便，但也意味着点一下就把请求的去向定了。所以只导入你正在用的那家中转站官网上给的配置；来路不明的导入链接不要点。导入后到提供方的配置页看一眼主机地址是不是你认识的那个。

目前导入的配置只支持 OpenAI 规范的接口。

检查失败时：错误码的含义

官方文档列了常见的错误码，接中转站时可以这样对照：

错误码	官方的解释	接中转站时先查什么
`400`	请求语法错误，参数或格式不对	模型名是否正确；勾的能力模型是否支持
`401`	鉴权或认证失败	key 是否复制完整，有没有多余的空格
`403`	服务器拒绝执行，可能是权限不足	这把 key 是否开通了这个模型；余额是否用完
`404`	请求的资源不存在	主机和路径是否拼对了，有没有重复的 `/v1`
`429`	访问次数超过了限制（官方举的例子是未实名用户每天的次数上限）	中转站的限流；等一会儿再试，或看它的控制台
`500`、`502`、`503`	服务器内部错误、上游无效响应、暂时无法处理	中转站或它的上游出了问题，不是你这边的配置

两件官方专门说明的事

数据存在哪里。 官方文档说明，聊天消息和设置都存在你的设备上，Chatbox 不会未经许可上传。但它同时写明：用第三方的 API 服务时，Chatbox 无法保证你的数据的隐私和安全，要自己去看那家服务的隐私政策和条款。接了中转站，你发的内容就会经过中转站，见用中转站有什么风险。

模型说自己是别的模型。 Chatbox 官方有一篇专门的说明：直接问模型“你是什么模型”得到的回答不可靠，模型的名称是训练完成后才确定的，它只能凭训练数据去猜；系统提示词被改掉或省略时更容易答错。本站的问“你是什么模型”为什么验证不了真假讲的是同一件事。

反过来也要注意：回答不可靠，意味着模型答对了同样说明不了问题。想知道中转站给的是不是它声称的模型，用同一把 key 到 Veridrop 检测，背景见中转站怎么掺假。

接上之后

“检查”通过只说明接口能通，不说明模型是真的，见上一节。
key 填在了每一台设备上。 手机丢了、换了设备，到中转站的控制台把 key 停用或换掉。
其他客户端的接法：Cherry Studio 接入中转站、LobeHub 接入中转站。