Cherry Studio 接入
通过自定义 OpenAI 类型 Provider 配置 UniGateway。
前置条件
- 已安装 Cherry Studio
- 已获取 UniGateway API Key
配置步骤
在 设置 > 模型服务 中：
| 步骤 | 操作 |
|---|---|
| 1 | 添加 Provider，类型 OpenAI |
| 2 | API Key：你的 UniGateway Key |
| 3 | API 地址：https://api.unigateway.ai/v1 |
| 4 | 添加 GET /v1/models 返回的模型 ID |
| 5 | 先测试一条普通聊天 |
Cherry Studio 内置的连接检测仅为基础检查，请发起一次真实请求确认。
验证
curl https://api.unigateway.ai/v1/models \
-H "Authorization: Bearer $UNIGATEWAY_API_KEY"
常见问题
| 问题 | 处理方式 |
|---|---|
| Provider 保存但请求失败 | 检查 API 地址是否包含 /v1 |
| 添加的模型不工作 | 从 GET /v1/models 确认模型 ID |
| UI 展示模型但运行时报错 | UI 列表反映配置状态，不是实时可用性 |