Chatbox 是桌面 AI 聊天客户端，支持通过 OpenAI-compatible 自定义接口接入云信大模型 API 平台（简称 AIHub）。

安装 Chatbox

1. 前往 Chatbox 官网，根据操作系统下载并安装客户端；也可直接使用 Chatbox Web 版本。

2. 安装完成后，点击页面左下角 设置 图标，进入模型提供方或 API 设置。

3. 点击 添加，API 模式选择 OpenAI API 兼容。

配置接入凭证

选择自定义 OpenAI-compatible 服务，按以下示例填写：

Chatbox 配置项	说明
API Host/Base URL	$AIHUB_BASE_URL/v1，例如 https://ai.yunxinapi.com/hub/v1
API Key	AIHUB_TOKEN，即 AIHub API 密钥 / 访问令牌
Model	AIHub 逻辑模型名称

配置示例：

textAPI Host: https://ai.yunxinapi.com/hub/v1
API Key: sk-...
Model: your-logical-model

验证配置

在 Chatbox 中选择该模型，发送：

text只回复 OK

如果控制台请求日志中出现 /v1/chat/completions 请求，说明配置已生效。

常见问题

现象	排查方向
连接失败	Base URL 应为 $AIHUB_BASE_URL/v1，不要只填写域名。
401/unauthorized	API Key 应填写 AIHub 访问令牌（AIHUB_TOKEN）。
模型下拉没有目标模型	手动添加模型，或先用 /v1/models 查询当前令牌可见的模型列表。
回复异常	检查目标模型、渠道能力和请求日志中的上游错误信息。