Chatbox 接入 Models Hub:配置 API 主机与密钥

在 Chatbox 桌面客户端里添加 OpenAI API 兼容模型提供方,填入 Models Hub 的 API 主机与密钥,即可用一个 Key 调用 Claude、GPT 等模型,附验证与报错排查。

Chatbox 是一款跨平台的桌面 AI 对话客户端,支持同时配置多个模型提供方。把它的模型提供方指向 Models Hub 后,聊天窗口发出的所有请求都会用 Models Hub 的额度。本文只讲接入,是这批教程里配置最简单的一篇,适合刚开始用 Models Hub 的用户入门。

三样东西

接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。整个过程一分钟内能完成。

准备

打开 Chatbox,进入 设置 → 模型提供方,点底部的 「添加」。
API 模式 选 「OpenAI API 兼容」。
API 密钥 粘贴你的 Models Hub Key。
API 主机 填:
```
https://modelsok.com/v1
```
API 路径 留空即可,不要在两处都写 /v1——Chatbox 会自动在主机地址后拼接默认路径。⚠️ 以上字段名来自 Chatbox 官方文档,具体控件位置以你当前版本界面为准。
模型一栏填入或选择上面表格里的模型名,保存。

新建一个对话,发一句「用一句话介绍你自己」,能正常回复即接通。再打开 Models Hub 控制台的用量日志,几秒内会出现一条对应模型名的请求,这一步能确认走的是 Models Hub 而不是 Chatbox 自带的服务。

现象	原因	处理
`401` / 提示密钥无效	Key 复制不完整、多了空格,或令牌已被禁用	到令牌页重新复制
发送后一直转圈或提示连接失败	API 主机地址写错,常见是漏了 `/v1` 或多打了斜杠	重新填 `https://modelsok.com/v1`,API 路径保持留空
提示模型不存在	模型名拼错,或令牌所在分组没有该模型	对照定价页核对
回复很慢或提示请求过多	触发限流,通常是并发过高	稍后重试;持续出现联系客服提额
用量日志里没有记录	对话窗口选的不是新添加的模型提供方	检查对话设置里的模型来源是否指向刚才添加的提供方

更多排查见故障排查。

计费方式? 按每次对话实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。

和直接用官方 API 有什么区别? 请求格式完全一致,只是把 API 主机换成了 Models Hub,不需要各家厂商单独开账号,一个 Key 能用多家模型。

怎么切换模型? 在对话界面顶部或右侧的模型选择器里直接切换,也可以在设置里给每个提供方添加多个模型来回切。