Cherry Studio 是目前桌面端最顺手的 AI 客户端之一:多模型切换、知识库、助手预设都齐了。但它本身不带模型,需要你接入一个"模型服务"。这篇教程用我们自己的聚合接口做示范,全过程同样适用于 ChatBox、NextChat、Lobe Chat 等任何支持自定义 OpenAI 接口的客户端。
第一步:拿到密钥和接口地址
接入任何第三方 API 前你需要两样东西:
- API Key(密钥)——相当于你的身份凭证,形如 sk-xxxxxxxx
- Base URL(接口地址)——告诉客户端去哪里请求,本站为 https://api.aigcbreeze.cn/v1
注册并登录控制台后,在「令牌」页面点新建令牌,复制生成的 Key 备用。Key 只在创建时完整显示一次,记得保存好。
第二步:在 Cherry Studio 中添加服务商
- 打开 设置 → 模型服务,点击左下角「添加」
- 名称随意(比如填 AIGC微风),API 地址填 https://api.aigcbreeze.cn(有的版本要求填到 /v1,两种都试试,以能拉取模型列表为准)
- API 密钥粘贴刚才创建的 Key
- 点击「管理」或「获取模型列表」,能看到模型就说明配置成功
如果拉取模型列表失败,九成是地址多了或少了一段路径。OpenAI 兼容接口的标准形态是「域名 + /v1」,客户端会自己在后面拼 /chat/completions。
第三步:选模型,开始对话
回到对话界面,在模型下拉里选择刚添加的模型即可。推荐几个起点:
- 日常写作、翻译 → deepseek-v4-flash(快、便宜)
- 复杂推理、代码 → glm-5.3 或 deepseek-v4-pro
- 长文档总结 → kimi-k3(超长上下文)
发一句"你好",有回复就全通了。完整模型 ID 列表见模型列表页。
常见问题
提示 401 / 鉴权失败?
Key 复制不完整(注意前后别带空格),或者用的是别的站点的 Key。重新复制一次。
提示 model not found?
模型 ID 拼写错误。ID 必须原样填写,包括大小写和横杠,比如 deepseek-v4-flash-0731 不能简写成 deepseek。
响应很慢?
先换一个轻量模型(flash 后缀)对比——如果轻量模型快、旗舰模型慢,属于正常现象(推理量不同);如果都慢,检查本机网络。