幫助中心
首頁 Alibaba Cloud Model Studio 操作指南（模型） 接入用戶端/開發工具 Dify

Dify

更新時間：
Copy as MD
產品

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

前提條件

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

1. 配置模型

1.1. 安裝模型供應商

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

說明

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

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

1.2. 配置 API Key

單擊頁面右上方的頭像-设置，在模型供應商處找到通义千问卡片，點擊设置。

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

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

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

20251127172111

1.3. 選擇模型

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

若外掛程式內暫未包含最新版千問模型，可嘗試安裝 OpenAI-API-compatible 外掛程式，在外掛程式設定中的 API endpoint URL 填入https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1（新加坡地區）或https://dashscope.aliyuncs.com/compatible-mode/v1（華北2（北京）地區）。其中WorkspaceId需替換為真實的擷取Workspace ID。

2. 開始使用

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

聊天助手/Agent

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

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

  2. 選擇模型

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

  3. 對話測試

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

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

Chatflow/工作流程

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

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

  2. 添加LLM節點

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

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

    在LLM節點編輯面板底部找到視覺開關並開啟，下方可設定解析度為高或低。

  3. 運行LLM節點

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

    運行完成後，輸出結果的text欄位中，思考內容被`

    ...

    `標籤包裹，標籤之後為模型的回複本文。

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

知識庫

  1. 建立知識庫

建立一個知識庫並進入。 2. 選擇資料來源

在此步驟上傳您的知識庫檔案。 3. 文本分段與清洗

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

gte-rerank-v2僅支援。
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. 下載並匯入工作流程範本

    下載我們寫好的模板：萬相-文生圖Demo.yml（ICMS 附件，file_id=135184，需線上下載）**Wanx - Text-to-Image Demo.yml（ICMS 附件，file_id=148265，需線上下載）或 萬相-文生視頻Demo.yml（ICMS 附件，file_id=135439，需線上下載）**Wanx - Text-to-Video Demo.yml（ICMS 附件，file_id=148266，需線上下載），在工作室單擊导入DSL文件並選擇下載的模板檔案。

  2. 配置環境變數

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

  3. 測試生圖效果

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

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

  4. 發布為工具（可選

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

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

Q4：如何私人化部署 Dify？

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

上一篇：Postman下一篇：更多工具