在 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、一张账单,不用为每家供应商单独开账号。

Chatbox ↗

  1. 获取 CaMeL Hub API Key

    登录 CaMeL Hub 控制台,打开「令牌」页面,新建一个令牌并复制密钥,下一步要粘贴到 Chatbox 里。这个 Key 相当于密码,泄露后任何人都能拿它消耗你的额度。
  2. 在 Chatbox 中新增自定义模型提供方

    打开 Chatbox,进入设置,再进入模型提供方界面(不同版本可能显示为「模型提供方」或「AI 提供方」),新增一个自定义提供方,起一个便于识别的名字,比如「CaMeL Hub」。
  3. 把 API 模式切到 OpenAI 兼容

    在该提供方的设置里找到名为「API 模式 / Provider Type」的字段,选择 OpenAI API Compatible(部分版本直接显示为 OpenAI)。这样 Chatbox 才会按 CaMeL Hub 实现的标准 /v1/chat/completions 协议发请求。
  4. 把域名和路径指向 CaMeL Hub

    Chatbox 把接入地址拆成两个字段:一个通常叫「API Host / API 域名」,另一个叫「API Path / 请求路径」。第一个字段只填裸域名,不要在这里加 /v1,因为路径字段会单独补上:
    API Host:  https://api.camel-hub.com
    API Path:  /v1/chat/completions
  5. 粘贴 API Key

    把第一步复制的 Key 粘贴到「API Key / 密钥」字段,保存这个提供方。
  6. 手动添加要用的模型 ID

    Chatbox 的自定义提供方不会自动拉取模型列表,需要逐个手动添加,名称要和 CaMeL Hub 控制台「模型」页面上显示的完全一致,例如:
    gpt-5.5
    claude-sonnet-5
    gemini-3.1-pro
    deepseek-v4-flash
  7. (可选)用 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"] }
        ]
      }
    }
  8. 发一条测试消息

    新建一个对话,选中刚才添加的模型,发一条简短消息。能收到回复就说明配置成功;可以到 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 字段确认。