跳到主要内容

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 把本站可用模型拉下来。

拉不到模型怎么办
  1. 确认地址末尾有 /v1
  2. 确认密钥复制完整、没带空格
  3. 手动添加也可以:在模型输入框直接写 MiniMax-M3.1-Flash 或 claude-opus-4-5

第五步:开聊​

在左侧模型列表选中新加的模型,回到聊天框发一句 你好 能回复即接通。

排错​

现象原因处理
获取模型报 401密钥错重新复制纯 sk- 字符串
获取模型 404地址少了 /v1补上 /v1
拉到的模型列表是空的令牌限制了模型范围控制台把「模型可用列表」清空
回复报 400模型名不在本站列表用 /v1/models 查真实模型名
一直转圈首次拉取索引较慢稍等几秒再试

相关:Chatbox 配置 · 客户端接入总览 · 小白教程