Cherry Studio 接入 XQAPI

在 Cherry Studio 中添加一个 OpenAI 兼容的自定义服务商，用同一个 XQAPI Key 调用公开文本模型。

准备工作

1. 1
   新增服务商

   打开设置 → 模型服务，点击添加自定义 OpenAI 服务商。

2. 2
   填写连接信息

   填写 XQAPI 根地址和 API Key，然后打开模型管理。

3. 3
   添加模型

   获取模型列表，添加所需模型，保存并启用服务商。

配置

复制与你的客户端对应的最小配置，再把占位密钥和模型 ID 替换为自己的值。

服务商类型：OpenAI
API 地址：https://ai.kuo.la
API Key：your-xqapi-key
模型 ID：从 XQAPI 模型库选择

验证

• 点击 API Key 输入框旁的检查按钮，确认连接成功。
• 新建对话并选择刚添加的 XQAPI 模型。
• 发送一条短消息，在 XQAPI 请求日志中确认调用和消耗记录。

常见问题

• API 地址只填站点根地址；Cherry Studio 会自动拼接 /v1/chat/completions。
• 不要填写完整的 /v1/chat/completions 地址，也不要在地址末尾添加 #。
• 从模型管理弹窗获取模型后，还需要点击 + 添加模型并启用服务商。