Cherry Studio 接入教程

国内用户很多的桌面 AI 客户端，支持一键导入，填好就能对话

接入步骤

  1. 最快：一键导入

    电脑上已装好 Cherry Studio 时，点本页上方的「一键导入」。浏览器询问是否打开 Cherry Studio 时点「打开」，Cherry Studio 会弹出确认框，确认来源是樱桃茶后点确定，服务商和 key 就自动填好了，接着从第 4 步添加模型。没装或导入失败，按第 2 步手动填。

  2. 手动添加服务商

    点左下角齿轮进入「设置」→「模型服务」→ 列表下方「+ 添加服务商」。「提供商名称」填 樱桃茶，「提供商类型」选「OpenAI」，点确定。

  3. 填 API 密钥和 API 地址

    在刚建好的服务商页面填下面两项。填好后地址栏下方的「预览」应显示 https://gpt.cherrychat.org/v1/chat/completions。

    • API 密钥：sk-你的密钥
    • API 地址：https://gpt.cherrychat.org（只填到域名，结尾不要加 # 或 /v1/chat/completions）

  4. 添加模型

    点「同步模型」（旧版叫「管理」或「获取模型列表」）拉取樱桃茶的模型，在列表里点模型右侧的「+」加入；也可以点「手动添加模型」，「模型 ID」填下面的名字。只有加进列表的模型才会出现在对话的模型选择里。

    • 模型 ID：gpt-6.1-sol

  5. 检测并启用

    点 API 密钥旁边的「检测」，选一个模型，显示成功就说明配置对了。然后打开服务商页面右上角的启用开关（列表里服务商名字旁出现绿点）。回到对话页，在顶部选择樱桃茶下的模型就能开始聊天。

容易踩的坑

报错 → 原因 → 怎么办

看到的报错原因怎么办
检测失败，报 401API 密钥复制错了、带了空格，或这把 key 已停用到 API 页「我的密钥」重新复制后粘贴
检测失败，报 404API 地址写成了 https://gpt.cherrychat.org/v1/chat/completions，或结尾加了 #改成 https://gpt.cherrychat.org，确认「预览」显示的是 https://gpt.cherrychat.org/v1/chat/completions
对话时提示模型不存在手动添加的模型 ID 写错了（大小写、多空格）删掉这个模型，用「同步模型」重新添加，或按模型价格页逐字填写
报 402 或「余额不足」（Claude 格式显示 billing_error）账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可
报 429 Too Many Requests请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试

教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。

API 接入 · API 模型价格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别

樱桃茶·智域GPT

网络有点慢，正在努力加载…