跳转到内容
ZiAI

接入 ChatBox

一句话结论：ChatBox 走 OpenAI 兼容协议，添加一个自定义提供方，填「API 主机 + API 密钥 + 模型」三样即可。

项目 值
协议 OpenAI Chat Completions
端点 https://api.ziai.lol/v1/chat/completions
密钥 ZiAI API 密钥（sk- 开头）
生效方式 保存后点「检查」，无需重启

前提

Section titled “前提”

配置步骤

Section titled “配置步骤”

  1. 打开设置

    点击 ChatBox 左下角（或侧边栏）的设置图标进入设置页。

  2. 进入「模型提供方」

    在设置页左侧选择 模型提供方（部分版本叫「模型」或「AI 提供方」）。

  3. 点击列表底部的「添加」

    弹出添加提供方对话框。若列表里已有你想要的名称，也可以直接选 添加自定义提供商。

  4. 填写名称与 API 模式

    • 名称：ZiAI（自己认得即可）
    • API 模式 / API 类型：选择 OpenAI API 兼容（OpenAI API Compatible）

  5. 填写 API 密钥与 API 主机

    字段 填什么
    API 密钥 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    API 主机 https://api.ziai.lol
    API 路径 留空，使用默认值 /v1/chat/completions

    主机填根域名、路径用默认值，拼出来正好是 /v1/chat/completions。

    粘贴密钥后输入框可能不显示明文，这是正常现象。

  6. 添加至少一个模型

    在模型列表里点「添加模型」，逐字粘贴从 ZiAI 查到的模型 ID。 按需勾选该模型的能力（视觉 / 联网 / 推理等）—— 不勾选则视为纯文本模型。

  7. 保存并点击「检查」

    保存后回到提供方设置页，点击 检查 按钮做连通性测试。提示连接成功即完成。

  8. 新建对话使用

    回到首页新建对话，在模型选择器里选中刚添加的模型即可开始聊天。

验证

Section titled “验证”

界面里点「检查」是最快的方式。想在命令行独立确认 ZiAI 侧没问题：

终端窗口
curl https://api.ziai.lol/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"model":"模型ID","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 且含 choices[0].message.content 即为正常。

ChatBox 专属常见问题

Section titled “ChatBox 专属常见问题”

下一步

Section titled “下一步”

ZiAI 中转站文档 · api.ziai.lol

合规提示：请遵守上游服务条款、平台规则与所在地法律法规；本站仅面向已获得合法授权的用户提供接入说明。 请勿在任何截图、日志或工单中粘贴真实 API 密钥。