Dify 串接教學
打造 AI 應用與工作流程的平台，裝一個 OpenAI 相容外掛就能用櫻桃茶的模型
- 介面：OpenAI Chat Completions
- 網址寫法：寫到 /v1（https://gpt.cherrychat.org/v1）
- 推薦模型：gpt-6.1-sol、deepseek-v4-flash
- 平台：網頁
串接步驟
安裝 OpenAI-API-compatible 外掛
進入「整合」→「模型供應商」（舊版：右上角頭像 →「設定」→「模型供應商」），在「安裝模型供應商」裡搜尋「OpenAI-API-compatible」並安裝。
新增模型
在 OpenAI-API-compatible 卡片上點「新增模型」，「模型類型」選 LLM，然後填寫下列各項。
- 模型名稱：gpt-6.1-sol（填模型 ID，不是顯示名稱）
- API Key：sk-你的金鑰
- API Base URL：https://gpt.cherrychat.org/v1（寫到 /v1，結尾不要再加 /）
填能力參數
「對話類型」選 Chat；「模型上下文長度」預設只有 4096，依「模型價格」頁調大（例如 128000）；「最大 token 上限」可填 8192；「函數呼叫類型」選「工具呼叫」（Tool Call），Agent 和工作流程才能用工具；「視覺支援」只給能看圖的模型選支援。
儲存並設為預設
點儲存，Dify 會先校驗 key 與網址。成功後點右上角「預設模型」，把「系統推理模型」選成它；在應用或工作流程的 LLM 節點裡也能直接選。
知識庫要用的 Embedding（選用）
知識庫需要向量模型時，再點一次「新增模型」，「模型類型」選 Text Embedding，模型名稱填 text-embedding-3-small，API Key 與 API Base URL 同上。
容易踩的坑
- API Base URL 寫到 /v1（https://gpt.cherrychat.org/v1），結尾不要多一個 /，也不要寫到 /chat/completions。
- 「模型名稱」填模型 ID（全小寫，和模型價格頁一致），不是自取的顯示名稱；顯示名稱填在「模型顯示名稱」裡。
- 「模型上下文長度」預設只有 4096，不改的話長文件和多輪對話會被截斷。
- 自架的 Dify 要確認伺服器能連到 https://gpt.cherrychat.org；Docker 裡的 Dify 走的是伺服器本身的網路。
錯誤訊息 → 原因 → 怎麼辦
| 看到的錯誤 | 原因 | 怎麼辦 |
|---|---|---|
| 儲存時提示憑證無效 / 401 | API Key 複製錯了、帶了空格，或這把 key 已停用 | 到 API 頁「我的金鑰」重新複製後再儲存 |
| 儲存時出現 404 | API Base URL 少了 /v1、結尾多了 /，或寫成了 https://gpt.cherrychat.org/v1/chat/completions | 改成 https://gpt.cherrychat.org/v1 |
| 提示模型不存在 | 「模型名稱」填了顯示名稱或拼錯 | 依模型價格頁逐字填寫模型 ID，例如 gpt-6.1-sol |
| 自架時一直連線逾時 | Dify 所在的伺服器連不到 https://gpt.cherrychat.org | 在伺服器上執行 curl https://gpt.cherrychat.org/v1/models 檢查網路，能回傳一段 JSON（就算是錯誤訊息）即為連通 |
| 出現 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 生成，請仔細甄別
