Chatbox 接入

Chatbox 是跨平台的 AI 聊天客户端（Windows / macOS / Linux / Web），通过自定义 OpenAI 兼容提供方接入 Router。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址
3. 安装 Chatbox（官网下载桌面版，或使用其 Web 版）

配置

1. 打开 Chatbox → 设置（Settings） → 模型提供方（Model Provider）
2. 选择添加自定义提供方（Add Custom Provider），类型选 OpenAI API 兼容
3. 填写：
   • 名称：VeyraOS Router（随意）
   • API 域名 / 地址：https://routerapi.<你的域名>/v1
   • API 密钥：你的 Key
   • 模型：添加控制台「可用模型」列表中的模型名
4. 保存

验证

新建对话，模型选刚配置的自定义提供方模型，发一条消息。正常回复即接入成功；控制台「调用记录」出现调用明细。

常见问题

Q：提示模型不存在？ 确认模型名与控制台「可用模型」列表完全一致（区分大小写）。

Q：连接失败？ 确认 API 地址以 /v1 结尾，且当前网络能访问该域名。