Chatbox 接入教程
电脑和手机都能用的 AI 对话客户端，支持一键导入配置
- 接口：OpenAI Chat Completions
- 地址写法：只写域名（https://gpt.cherrychat.org）
- 推荐模型：gpt-6.1-sol、claude-sonnet-5-5
- 平台：macOS、Windows、Linux、iOS、Android、网页
接入步骤
最快：一键导入
装好 Chatbox（1.15.1 或更新版本）后，点本页上方的「一键导入」，浏览器询问时允许打开 Chatbox，在弹窗里确认导入，樱桃茶的地址、key 和推荐模型会自动填好，然后直接看第 5 步「检查」。导入失败就按第 2 步手动添加。
手动添加模型提供方
打开 Chatbox，点侧边栏底部的「设置」→「模型提供方」→ 列表底部的「添加」。「名称」填 樱桃茶，「API 模式」选「OpenAI API 兼容」，点「添加」。
填 API 密钥和 API 主机
「API 路径」留空不填。填好后，下方「预览」应显示 https://gpt.cherrychat.org/v1/chat/completions。
- API 密钥：sk-你的密钥（不要自己加 Bearer）
- API 主机：https://gpt.cherrychat.org（填域名即可，Chatbox 会自动补 /v1/chat/completions）
添加模型
在「模型」区域点「获取」从樱桃茶拉取模型列表，勾选要用的；或者点「新建」，模型 ID 填下面的名字。至少要有一个模型才能检查连接。
- 模型 ID：gpt-6.1-sol
检查连接并开始对话
点 API 密钥旁边的「检查」，出现「连接成功！」就好了。回到首页新建对话，在底部「选择模型」里选樱桃茶下的模型即可。
容易踩的坑
- API 主机填域名，API 路径留空，以「预览」那一行为准。主机写成 https://gpt.cherrychat.org/v1 也能用，但这时 API 路径不能再写 /v1/chat/completions，否则会变成 /v1/v1/…。
- API 模式选「OpenAI API 兼容」，不要选 Claude 或 Gemini 兼容（本教程按 Chat 接口写）。
- key 前后不要带空格，也不要手动加 Bearer 前缀。
- 一键导入需要 Chatbox 1.15.1 或更新版本；导入链接里含有你的 key，不要转发给别人。
报错 → 原因 → 怎么办
| 看到的报错 | 原因 | 怎么办 |
|---|---|---|
| 检查失败，报 401 | API 密钥复制错了、多了空格或 Bearer，或这把 key 已停用 | 到 API 页「我的密钥」重新复制后粘贴 |
| 检查失败，报 404 | 「预览」里的地址不是 https://gpt.cherrychat.org/v1/chat/completions：API 路径多写了 /v1，或主机里写了完整路径 | API 主机改回 https://gpt.cherrychat.org，API 路径清空 |
| 对话时提示模型不存在 | 「新建」的模型 ID 写错了 | 改用「获取」拉取列表，或按模型价格页逐字填写 |
| 报 402 或「余额不足」（Claude 格式显示 billing_error） | 账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣 | 到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可 |
| 报 429 Too Many Requests | 请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求 | 调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试 |
教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别
