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

網路有點慢，正在努力載入…