Cherry Studio 是桌面 AI 客户端，支持通过配置自定义模型供应商，以 OpenAI-compatible 方式接入云信大模型 API 平台（简称 AIHub）。

安装 Cherry Studio

1. 前往 Cherry Studio 页面，根据操作系统下载安装包并完成安装。
2. 首次启动后进入设置页面。
3. 在设置中打开 模型 或 模型服务 配置，点击 添加供应商。
4. 供应商类型选择 OpenAI-compatible/自定义 OpenAI，供应商名称可填写 Aihub。

配置接入凭证

新增自定义 OpenAI-compatible provider，按以下示例填写：

Cherry Studio 配置项	说明
供应商类型	OpenAI-compatible/自定义 OpenAI
API 地址	$AIHUB_BASE_URL/v1，例如 https://ai.yunxinapi.com/hub/v1
API 密钥	AIHUB_TOKEN，即 AIHub API 密钥 / 访问令牌
模型 ID	AIHub 模型名称

配置示例：

textAPI 地址: https://ai.yunxinapi.com/hub/v1
API 密钥: sk-...
模型 ID: your-logical-model

验证配置

在 Cherry Studio 中选择该模型，发送：

text只回复 OK

控制台请求日志中出现标准推理请求（如 /v1/chat/completions）即表示接入成功。

常见问题

现象	排查方向
模型测试失败	先用 curl 验证同一 Base URL、Token 和模型名是否正常。
401/unauthorized	API 密钥应填写 AIHub 访问令牌（AIHUB_TOKEN）。
参数报错	Cherry Studio 可能发送了模型不支持的扩展参数；建议关闭高级参数后重试。
免费额度或用量疑问	以 AIHub 控制台请求日志、用量统计和计费配置为准。