Cherry Studio 接入
你可以通过自定义 provider 或 OpenAI 类型 provider，把 UniGateway 接入 Cherry Studio。
需要配置的内容
Cherry Studio 的自定义服务商流程允许你设置：
- Provider type：
OpenAI - API key：你的 UniGateway key
- API address / Base URL：
https://api.unigateway.ai/v1 - Model IDs：
GET /v1/models返回的精确值
推荐配置顺序
- 打开
Settings。 - 进入
Model Services。 - 新增一个 provider，类型选择
OpenAI。 - 填入 UniGateway 的 API key 和 base URL。
- 手工添加一个来自
GET /v1/models的稳定模型 ID。 - 先验证一次普通聊天，再逐步开启更多模型。
配置说明
| 项目 | 建议 |
|---|---|
| Provider 类型 | 使用 OpenAI 兼容路径，不要自己发明请求结构 |
| Base URL | 使用带 /v1 的 UniGateway API 根地址 |
| 模型管理 | 显式录入模型 ID，并在目录变化后重新核对 |
| Key 校验 | Cherry Studio 的内置检查只能当第一步，仍要跑一次真实请求 |
常见失败场景
| 问题 | 处理方式 |
|---|---|
| Provider 能保存，但请求失败 | 重新检查 API address，并确认包含 /v1 |
| 添加的模型不可用 | 用 GET /v1/models 再核对一次精确模型 ID |
| UI 里能看到模型，但运行时报错 | UI 列表只是配置状态，不代表实时可用性 |
| 一问多答表现不一致 | 在开启多模型对比前，先逐个模型单独验证 |