客户端接入 · Chatbox

Chatbox 接入 HardysAPI:API Host 怎么填

Chatbox 桌面版与手机版都支持「OpenAI API 兼容」,填一个 API Host 就能用上全部模型。Host 里必须带 /v1,这是最容易填错的一处。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤

  1. 打开 设置 → 模型提供方,选 OpenAI API 兼容(有的版本叫「自定义提供方」);
  2. API Host 填 https://hardysapi.com/v1;
  3. API 密钥粘贴 sk-...;
  4. 模型一栏输入模型名,例如 claude-sonnet-4-5,可加多个;
  5. 保存后在对话页顶部切换到这个模型。
⚠️ Chatbox 的 API Host 不会自动补 /v1。填成 https://hardysapi.com 会请求到 /chat/completions 而报 404,必须写成 https://hardysapi.com/v1。

手机版同样可用

iOS / Android 版入口在「设置 → 模型提供方」,字段与桌面版一致,粘贴同一个密钥即可。 如果手机上打不开控制台,可以先在电脑上创建密钥再复制过去。

常见坑

  • 401 Unauthorized:密钥不完整(漏了尾部字符)或复制时带了空格;重新复制一次。
  • 模型报错但别的模型正常:该模型不在密钥所属分组,换分组或换模型。
  • 流式输出卡住:把「流式输出」关掉试一次,能区分是网络问题还是上游问题。

验证

列出可用模型bash
curl https://hardysapi.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回的 data 数组就是当前分组可用的模型名,直接照着填进 Chatbox 的模型列表, 能避免手打模型名出错。

常见问题

Chatbox 的 API Host 应该填 https://hardysapi.com 还是加 /v1?

填 https://hardysapi.com/v1。Chatbox 不会自动补 /v1,缺了会 404。

Chatbox 能同时配多个中转站吗?

可以。每个提供方是一个独立配置,切换提供方即可切换上游,密钥分别填写。