整合指南
在 Dify 中使用
在 Dify 的模型供應商裡新增 OpenAI-API-compatible 模型，填入土土金 API Key、API endpoint URL https://www.tutujin.com/v1 和模型名，就能在應用編排和知識庫裡使用 GPT、Claude、DeepSeek 等模型。
Dify 通過「OpenAI-API-compatible」模型供應商接入土土金 API：新增模型時填入土土金的 API Key、API endpoint URL https://www.tutujin.com/v1 和模型名。每個模型新增一次，之後在應用編排、工作流和知識庫裡都能直接選用。
下面按 Dify 1.x 的介面描述。Dify 版本更新較快，選單名稱和欄位位置可能和你看到的略有不同，填寫的內容是一樣的。
第 1 步：安裝 OpenAI-API-compatible
- 進入 Dify 的「設定」→「模型供應商」。
- 如果列表裡沒有「OpenAI-API-compatible」，到外掛市場搜尋並安裝它。Dify 1.0 之後，模型供應商以外掛形式提供。
第 2 步：新增對話模型
在 OpenAI-API-compatible 上點「新增模型」，按下表填寫：
| 欄位 | 填寫 |
|---|---|
| 模型類型 | LLM |
| 模型名稱 | 模型廣場裡的模型名，例如 deepseek-v4.1-flash |
| API Key | 土土金 API Key |
| API endpoint URL | https://www.tutujin.com/v1 |
| Completion mode | Chat |
| 模型上下文長度、最大 token 上限 | 按所選模型官方公佈的數值填寫 |
| Function calling、Vision 支援 | 模型本身支援時再開啟 |
儲存後，在應用的模型下拉框裡就能選到這個模型。想用多個模型，就重複新增，每個模型名一條。
第 3 步：新增向量模型（知識庫用）
Dify 知識庫需要一個向量模型。同樣點「新增模型」：
| 欄位 | 填寫 |
|---|---|
| 模型類型 | Text Embedding |
| 模型名稱 | 例如 text-embedding-3-small |
| API Key | 土土金 API Key |
| API endpoint URL | https://www.tutujin.com/v1 |
新增後在「系統模型設定」裡把它設為預設的 Embedding 模型。如果你的 Dify 版本在這個供應商下支援 Rerank 類型，也可以用同樣方式新增重排模型，例如 qwen3-reranker-8b。
知識庫建好之後不要隨意更換向量模型。不同向量模型生成的向量不能混用，換模型需要重新向量化全部文件。
只用 GPT 模型時
如果只用 OpenAI 的模型，也可以直接配置 Dify 自帶的「OpenAI」供應商：API Key 填土土金的 Key，API Base 填 https://www.tutujin.com/v1。呼叫其他廠商的模型時，用 OpenAI-API-compatible 更合適。
測試與計費
在應用的除錯面板發一條訊息，能正常回復就說明配置成功。之後每次呼叫都會出現在土土金控制台的「操作日誌」裡，按 Key 所在分組的價格計費。可以給 Dify 單獨建一把 Key，並設定額度上限，見認證與 Base URL。
常見問題
| 現象 | 原因與處理 |
|---|---|
| 儲存模型時校驗失敗 | 檢查 API endpoint URL 是否為 https://www.tutujin.com/v1，模型名是否和模型廣場一致 |
| 401 | Key 填錯或已失效 |
503 並提示 model_not_found | Key 所在分組沒有這個模型，見選擇分組 |
| 回答被截斷 | 調大模型的最大 token 上限 |
沒找到答案？加客服微信 JsnonoChat，傳送報錯資訊裡的 request id，我們幫你排查。