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 Key 與 API 主機
「API 路徑」留空不填。填好後，下方「預覽」應顯示 https://gpt.cherrychat.org/v1/chat/completions。
- API Key：sk-你的金鑰（不要自己加 Bearer）
- API 主機：https://gpt.cherrychat.org（填網域即可，Chatbox 會自動補 /v1/chat/completions）
新增模型
在「模型」區域點「獲取」從櫻桃茶拉取模型清單，勾選要用的；或點「新增」，模型 ID 填下方名稱。至少要有一個模型才能檢查連線。
- 模型 ID：gpt-6.1-sol
檢查連線並開始對話
點 API Key 旁邊的「檢查」，出現「連線成功！」就好了。回到首頁新增對話，在底部「選擇模型」裡選櫻桃茶底下的模型即可。
容易踩的坑
- 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 Key 複製錯了、多了空格或 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 生成，請仔細甄別
