Cherry Studio 与 Chatbox

桌面聊天客户端通常可以通过“OpenAI 兼容”方式接入 Cloud AI。

通用配置

字段	填写内容
服务商类型	OpenAI Compatible / 自定义 OpenAI
API 地址	https://cloud.examplea.xyz/v1
API 密钥	sk-your-key
模型	当前分组支持的模型名称

Cherry Studio

1. 打开“设置”中的模型服务。
2. 新增 OpenAI 兼容服务商。
3. 填写 API 地址和密钥。
4. 点击获取模型；如果客户端无法自动获取，则手动添加模型名称。
5. 保存后新建对话测试。

Chatbox

1. 打开“设置”并选择自定义提供方。
2. API 模式选择 OpenAI API。
3. 填写 API Host、密钥和模型。
4. 保存后发送短消息验证。

地址填写差异

部分客户端会自动追加 /v1，部分不会：

• 字段名为 Base URL 或 API Host 时，通常填写 https://cloud.examplea.xyz/v1。
• 如果界面提示“请勿包含 /v1”，则填写 https://cloud.examplea.xyz。
• 出现 404 或路径中有两个 /v1/v1 时，删除其中一个 /v1。

TIP

客户端“连接测试”失败不一定代表聊天接口不可用。部分测试会请求客户端特定端点， 应再创建一个实际对话确认。