全部產品
Search

搜尋本產品

    Alibaba Cloud Model Studio：Dify

    文件中心

    Alibaba Cloud Model Studio：Dify

    更新時間：Nov 29, 2025

    Dify 是一個開源的大模型應用開發平台，您可以基於阿里雲百鍊提供的模型 API 來構建大模型應用。

    前提條件

    您需要擷取與配置 API Key，並確保已開通阿里雲百鍊的模型服務。

    1. 配置模型

    1.1. 安裝模型供應商

    前往Dify 市場，在模型下找到通義千問並安裝最新版外掛程式。

    image.png

    說明

    • 通義千問外掛程式非阿里雲提供，由 Dify 官方維護。若安裝最新版外掛程式報錯，可嘗試安裝較早版本。

    • 使用阿里雲百鍊提供的 DeepSeek 模型也請使用通義千問外掛程式。

    1.2. 配置 API Key

    單擊頁面右上方的頭像-設定，在模型供應商處找到通義千問卡片，點擊設定。

    • 若使用國際（新加坡）地區模型，在卡片的 API-KEY 設定介面填入國際版 API Key，並設定使用國際端點為是。

    • 若使用中國大陸（北京）地區模型，在卡片的 API-KEY 設定介面填入中國大陸版 API Key，並設定使用國際端點為否。

    若 API Key 配置過程報錯：Invalid API-key provided，可嘗試安裝較早版本的通義千問外掛程式。

    20251127172111

    1.3. 選擇模型

    單擊通義千問卡片中的顯示模型，開啟您需要使用的模型開關。

    若外掛程式內暫未包含最新版通義千問模型，可嘗試安裝 OpenAI-API-compatible 外掛程式，在外掛程式設定中的 API endpoint URL 填入https://dashscope-intl.aliyuncs.com/compatible-mode/v1（新加坡地區）或https://dashscope.aliyuncs.com/compatible-mode/v1（北京地區）。

    20251127174026

    2. 開始使用

    Dify 具有多種大模型應用類型，請選擇您使用的類型進行參考。

    聊天助手/Agent

    1. 建立一個聊天助手或Agent

      在工作室單擊建立空白應用，在新手適用中建立一個聊天助手或Agent並進入。

    2. 選擇模型

      在應用頁面右上方可以選擇模型，以通義千問下的qwen-plus-latest(Qwen3)為例，開啟思考模式並設定為True。

      20251127175428

    3. 對話測試

      輸入“你是誰”，模型會在思考後進行回答。

      image.png

      您也可以使用 Qwen-VL 或 QVQ 模型針對圖片進行提問。在選擇視覺模型後介面左側會出現視覺開關，開啟即可在右側的對話方塊輸入圖片。

      20251127194449

    Chatflow/工作流程

    1. 建立一個Chatflow或者工作流程

      在工作室建立一個Chatflow或者工作流程並進入。

    2. 添加LLM節點

      在畫布中添加一個LLM節點，選中節點進入編輯介面，選擇您需要使用的模型。此處選擇qwen-plus-2025-07-28(Qwen3)，開啟思考模式並設定為True。

      20251127195334

      如果您使用 Qwen-VL 或 QVQ 模型，請開啟LLM節點的視覺開關：

      20251127200241

    3. 運行LLM節點

      單擊添加訊息，在USER對應的訊息下輸入問題：“你是誰”，單擊節點右上方的運行按鈕20251127203142。

      20251127202909

      LLM節點返回的text欄位包含思考與回複內容，您可以使用Dify的代碼執行節點，通過Regex分別提取。

    知識庫

    1. 建立知識庫

      建立一個知識庫並進入。

    2. 選擇資料來源

      在此步驟上傳您的知識庫檔案。

    3. 文本分段與清洗

      您可以在此步驟配置阿里雲百鍊提供的 Embedding 模型與 Rerank 模型，此處以 text-embedding-v4 與 gte-rerank-v2 為例。其餘參數請您按需配置。

      gte-rerank-v2僅支援中國大陸（北京）地區。

      20251127203834

      Embedding 模型暫時無法選擇multimodal-embedding-v1模型，敬請關注後續動態。

    常見問題

    Q1：在通義千問外掛程式內配置 API Key 報錯？

    A：有以下常見原因：

    • 最新版外掛程式效能可能不穩定，請嘗試安裝較低版本外掛程式。

    • 使用了子業務空間的 API Key。0.0.41版本的通義千問外掛程式會校正qwen-turbo模型調用許可權，請為qwen-turbo添加模型調用許可權。

      通義千問外掛程式非阿里雲官方維護，後續版本校正策略以實際情況為準。建議使用預設業務空間的 API Key。

    • 端點設定錯誤，請根據 API Key 所在地區設定是否 使用國際端點。

    Q2：如何使用 Qwen-Omni/Qwen-OCR模型？

    A：以上模型均不支援直接在 Dify 上配置，您可通過 Chatflow 或工作流程的 HTTP 節點接入，接入細節請參見文檔中的 Curl 命令。

    為了降低HTTP節點的逾時風險，建議您通過流式輸出方式調用。

    Q3：如何使用通義萬相模型？

    A：Dify 沒有提供通義萬相模型相關的外掛程式，通過Dify的Chatflow/工作流程的節點可達到文生圖/視頻的功能。請參考以下步驟：

    1. 下載並匯入工作流程範本

      下載我們寫好的模板：Wanx - Text-to-Image Demo.yml或 Wanx - Text-to-Video Demo.yml，在工作室單擊匯入DSL檔案並選擇下載的模板檔案。

    2. 配置環境變數

      進入工作流程介面，找到image.png，並將DASHSCOPE_API_KEY的值修改為您的API Key。

    3. 測試生圖效果

      單擊介面的運行按鈕即可產生作品。以文生圖工作流程輸入“小貓”為例，可以得到圖片：

      image.png

      視頻產生工作流程會返回視頻的URL。
      文生視頻的時間一般在5分鐘以上，請耐心等待。

    4. 發布為工具（可選

      為了在其它大模型應用中使用通義萬相的文生圖/視頻功能，您可以在介面右上方單擊發布並選擇發布為工具。

    模板使用的模型為新加坡地區的wan2.2-t2i-flash（文生圖）/wan2.1-t2v-turbo（文生視頻）。您可以在STEP1節點修改模型，在STEP1和STEP3節點修改地區API。

    Q4：如何私人化部署 Dify？

    A：Dify 雲端服務存在多項限制，例如最多建立 5 個應用。私人化部署請參見阿里雲 Dify 部署解決方案。