Cherry Studio 配置
Cherry Studio 是免费开源的国产多模型桌面客户端,主打「一个窗口管理所有模型」。 对第一次用 小关API 的用户,它是最推荐的图形界面客户端。
下载:https://www.cherryai.com.cn/download
先看这里
Cherry Studio 有新旧两版界面:旧版「设置」在右上角齿轮,新版在左下角。 两个位置都找一下即可。
需要填的三样东西
| 字段 | 填什么 |
|---|---|
| 提供商名称 | 随便填,建议 xiaoguan |
| API 密钥 | 控制台「令牌管理」创建的 sk-... |
| API 地址 | https://api.yzgz.cn/v1 |
配置步骤
第一步:打开设置
启动 Cherry Studio,点齿轮图标进入设置 → 左侧选「模型服务」。
第二步:添加提供商
点「+ 添加服务商」,选 OpenAI 类型(兼容 OpenAI 协议的那种)。
类型别选错
要选 OpenAI / 兼容 类型,不要选 Anthropic 类型。
Cherry Studio 走的是 OpenAI 协议,地址必须带 /v1。
第三步:填密钥和地址
| 表单位置 | 填写内容 |
|---|---|
| API 密钥 | sk-你的密钥 |
| API 地址 | https://api.yzgz.cn/v1 |
第四步:获取模型
点「获取模型列表」(或刷新按钮),Cherry Studio 会请求 GET /v1/models 把本站可用模型拉下来。
拉不到模型怎么办
- 确认地址末尾有
/v1 - 确认密钥复制完整、没带空格
- 手动添加也可以:在模型输入框直接写
MiniMax-M3.1-Flash或claude-opus-4-5
第五步:开聊
在左侧模型列表选中新加的模型,回到聊天框发一句 你好 能回复即接通。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 获取模型报 401 | 密钥错 | 重新复制纯 sk- 字符串 |
| 获取模型 404 | 地址少了 /v1 | 补上 /v1 |
| 拉到的模型列表是空的 | 令牌限制了模型范围 | 控制台把「模型可用列表」清空 |
| 回复报 400 | 模型名不在本站列表 | 用 /v1/models 查真实模型名 |
| 一直转圈 | 首次拉取索引较慢 | 稍等几秒再试 |
相关:Chatbox 配置 · 客户端接入总览 · 小白教程