在 Chatbox 中接入 CaMeL Hub:一个 Key 通吃 GPT、Claude、Gemini、DeepSeek
Chatbox 是一款免费开源的 AI 对话客户端,覆盖 Windows、macOS、Linux、iOS、Android 和网页版,界面简洁、对话记录本地保存,并且支持任何兼容 OpenAI 协议的 API 端点,而不是绑死某一家厂商。把它接到 CaMeL Hub 而不是某家官方接口,同一个客户端就能调用 GPT-5.5、Claude Sonnet 5、Gemini 3.1 Pro、DeepSeek V4 Flash 等几十个模型——一个 Key、一张账单,不用为每家供应商单独开账号。
-
获取 CaMeL Hub API Key
登录 CaMeL Hub 控制台,打开「令牌」页面,新建一个令牌并复制密钥,下一步要粘贴到 Chatbox 里。这个 Key 相当于密码,泄露后任何人都能拿它消耗你的额度。 -
在 Chatbox 中新增自定义模型提供方
打开 Chatbox,进入设置,再进入模型提供方界面(不同版本可能显示为「模型提供方」或「AI 提供方」),新增一个自定义提供方,起一个便于识别的名字,比如「CaMeL Hub」。 -
把 API 模式切到 OpenAI 兼容
在该提供方的设置里找到名为「API 模式 / Provider Type」的字段,选择 OpenAI API Compatible(部分版本直接显示为 OpenAI)。这样 Chatbox 才会按 CaMeL Hub 实现的标准 /v1/chat/completions 协议发请求。 -
把域名和路径指向 CaMeL Hub
Chatbox 把接入地址拆成两个字段:一个通常叫「API Host / API 域名」,另一个叫「API Path / 请求路径」。第一个字段只填裸域名,不要在这里加 /v1,因为路径字段会单独补上:API Host: https://api.camel-hub.com API Path: /v1/chat/completions -
粘贴 API Key
把第一步复制的 Key 粘贴到「API Key / 密钥」字段,保存这个提供方。 -
手动添加要用的模型 ID
Chatbox 的自定义提供方不会自动拉取模型列表,需要逐个手动添加,名称要和 CaMeL Hub 控制台「模型」页面上显示的完全一致,例如:gpt-5.5 claude-sonnet-5 gemini-3.1-pro deepseek-v4-flash -
(可选)用 JSON 一键导入整套配置
Chatbox 1.15.1 及以上版本支持用一段 JSON 一次性导入提供方配置(设置 → 模型提供方 → 导入)。复制下面这段,再根据实际要用的模型增删列表——上下文窗口、最大输出等具体数值请以 CaMeL Hub「模型」页面当前显示为准,不要照抄旧配置,供应商的模型规格会随时间变化:{ "id": "camelhub", "name": "CaMeL Hub", "type": "openai", "urls": { "website": "https://api.camel-hub.com/console/", "getApiKey": "https://api.camel-hub.com/console/token", "docs": "https://api.camel-hub.com/docs", "models": "https://api.camel-hub.com/console/models" }, "settings": { "apiHost": "https://api.camel-hub.com", "apiPath": "/v1/chat/completions", "models": [ { "modelId": "gpt-5.5", "nickname": "GPT-5.5", "type": "chat", "capabilities": ["vision", "tool_use"] }, { "modelId": "claude-sonnet-5", "nickname": "Claude Sonnet 5", "type": "chat", "capabilities": ["vision", "tool_use"] }, { "modelId": "gemini-3.1-pro", "nickname": "Gemini 3.1 Pro", "type": "chat", "capabilities": ["vision", "reasoning", "tool_use"] }, { "modelId": "deepseek-v4-flash", "nickname": "DeepSeek V4 Flash", "type": "chat", "capabilities": ["tool_use"] } ] } } -
发一条测试消息
新建一个对话,选中刚才添加的模型,发一条简短消息。能收到回复就说明配置成功;可以到 CaMeL Hub 控制台的用量/日志页面确认这条请求已经计费到你的账号下。
常见问题
Chatbox 里模型列表是空的,加载不出来。
这是正常现象——自定义的 OpenAI 兼容提供方不会去 CaMeL Hub 拉取实时模型列表,需要手动添加(第 6 步)或用 JSON 一次性导入(第 7 步)。添加时注意模型 ID 要和控制台「模型」页面上的名称完全一致,包括大小写和版本后缀。
Key 验证失败,或者连接测试不通过。
最常见的原因是 /v1 被重复填了两遍——如果「API Host」填成了 https://api.camel-hub.com/v1,而「API Path」又以 /v1/chat/completions 开头,请求地址就会拼错、404。正确做法是 API Host 只填裸域名 https://api.camel-hub.com,/v1/chat/completions 交给 API Path 字段承担。同时确认这把 Key 没有被撤销、账号还有余额。
Chatbox 里日常聊天该选哪个模型?
追求速度和低成本,优先选 deepseek-v4-flash 或较轻量的 GPT 模型;写代码、处理长文档或需要工具调用的场景,claude-sonnet-5 或 gpt-5.5 推理更强,但单价也更高——设为默认之前先去价格页确认当前费率。
流式回复输出到一半就断了,或者一次性整段蹦出来而不是逐字流式。
先确认提供方或模型设置里的「流式 / Stream」开关是打开的——Chatbox 对 OpenAI 兼容提供方默认走流式,但部分版本按模型单独设置。如果内容还是被截断,通常是模型自身触达了最大输出长度,而不是 CaMeL Hub 侧的问题;如果所用版本的 Chatbox 暴露了响应详情,可以看 finish_reason 字段确认。