适用边界
Cherry Studio 适合作为桌面聊天、模型对比和轻量多模态测试客户端。Ling.AI 接入时把它配置成自定义模型服务商，服务商类型选择 OpenAI / OpenAI Compatible，API 地址填写 https://api.lingyuncx.com/v1。
CC Switch 说明
CC Switch 当前公开支持的 app-specific provider 不包含 Cherry Studio。Cherry Studio 请在自己的“模型服务”设置里配置，不要套用 CLI 工具的 CC Switch provider。
准备
- 安装 Cherry Studio，确认能打开 Settings / 设置。
- 在 Ling.AI 控制台创建 API Key，确认余额、套餐和模型授权可用。
- 请求
GET https://api.lingyuncx.com/v1/models，记录需要添加到 Cherry Studio 的模型 ID。
新增服务商
- 打开设置。 在 Cherry Studio 左侧导航点击齿轮图标进入 Settings / 设置。
- 进入模型服务。 在设置页选择 Model Services / 模型服务。
- 点击添加。 在服务商列表底部点击 + Add / 添加。
- 填写服务商名称。 名称建议填
Ling.AI。 - 选择服务商类型。 选择 OpenAI 或当前版本中的 OpenAI Compatible 等价选项。
填写参数
| 字段 | 填写值 | 说明 |
|---|---|---|
| Provider Name | Ling.AI |
便于和其它服务商区分。 |
| Provider Type | OpenAI / OpenAI Compatible |
以当前 Cherry Studio 版本文案为准。 |
| API Key | sk-xxxxxxxx |
填 Ling.AI API Key，可用页面里的 Check / 检查按钮验证。 |
| API Address / Base URL | https://api.lingyuncx.com/v1 |
不要填写网站首页，也不要追加 /chat/completions。 |
添加模型
- 打开模型管理。 在 Ling.AI 服务商下点击 + Add / 添加模型 或 Manage / 管理入口。
- 填写模型 ID。 Model ID 填
/v1/models返回的真实id。 - 填写展示名。 模型名称可以和 ID 一致，或填便于识别的中文名称。
- 保存模型。 添加多个模型时，每个模型 ID 都必须先从当前账号的
/v1/models确认。 - 进入聊天页。 选择 Ling.AI 服务商和刚添加的模型，发送短 prompt。
验证
- 先点击 Check / 检查 API Key。
- 发送一条短文本请求。
- 确认 Cherry Studio 收到回复。
- 回到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
排障
| 问题 | 先检查 | 处理方式 |
|---|---|---|
| Check 失败 | API Key、Base URL、网络出口 | 用 curl 请求 /v1/models 验证 Key 和网络。 |
| 模型列表没有目标模型 | 是否手动添加模型 ID | 在模型管理中添加 /v1/models 返回的 ID。 |
| 图像/音频能力不可用 | 模型能力和 Cherry Studio 模块支持 | 只在模型目录和客户端版本都支持时启用对应模态。 |
| 扣费或 usage 对不上 | 是否选中了正确服务商和模型 | 核对 Ling.AI 请求记录中的模型 ID，再检查 Cherry Studio 当前聊天模型。 |