首页 / 教程 / 客户端配置

Cherry Studio 怎么接入第三方 API?三分钟配好你的 AI 工作台

Cherry Studio 是目前桌面端最顺手的 AI 客户端之一:多模型切换、知识库、助手预设都齐了。但它本身不带模型,需要你接入一个"模型服务"。这篇教程用我们自己的聚合接口做示范,全过程同样适用于 ChatBox、NextChat、Lobe Chat 等任何支持自定义 OpenAI 接口的客户端

第一步:拿到密钥和接口地址

接入任何第三方 API 前你需要两样东西:

注册并登录控制台后,在「令牌」页面点新建令牌,复制生成的 Key 备用。Key 只在创建时完整显示一次,记得保存好。

第二步:在 Cherry Studio 中添加服务商

  1. 打开 设置 → 模型服务,点击左下角「添加」
  2. 名称随意(比如填 AIGC微风),API 地址填 https://api.aigcbreeze.cn(有的版本要求填到 /v1,两种都试试,以能拉取模型列表为准)
  3. API 密钥粘贴刚才创建的 Key
  4. 点击「管理」或「获取模型列表」,能看到模型就说明配置成功
如果拉取模型列表失败,九成是地址多了或少了一段路径。OpenAI 兼容接口的标准形态是「域名 + /v1」,客户端会自己在后面拼 /chat/completions。

第三步:选模型,开始对话

回到对话界面,在模型下拉里选择刚添加的模型即可。推荐几个起点:

发一句"你好",有回复就全通了。完整模型 ID 列表见模型列表页

常见问题

提示 401 / 鉴权失败?

Key 复制不完整(注意前后别带空格),或者用的是别的站点的 Key。重新复制一次。

提示 model not found?

模型 ID 拼写错误。ID 必须原样填写,包括大小写和横杠,比如 deepseek-v4-flash-0731 不能简写成 deepseek。

响应很慢?

先换一个轻量模型(flash 后缀)对比——如果轻量模型快、旗舰模型慢,属于正常现象(推理量不同);如果都慢,检查本机网络。

边看边练,效果最好

注册即可创建密钥,OpenAI 兼容接口,本文所有示例直接可用。

留言交流

有问题、有补充,写两句吧~留言会实时显示在下方(无需注册)。

留言加载中…
← 上一篇:上下文长度科普 下一篇:ChatBox 配置教程 →