Dify

​

前提條件

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

​

1. 配置模型

​

1.1. 安裝模型供應商

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

​

1.2. 配置 API Key

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

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

若 API Key 配置過程報錯：Invalid API-key provided，請參見 1.1. 安裝模型供應商 中關於外掛程式版本的說明。

​

1.3. 選擇模型

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

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

​

2. 開始使用

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

​

常見問題

​

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

A：有以下常見原因：

• 最新版外掛程式效能可能不穩定，請參見 1.1. 安裝模型供應商 中關於外掛程式版本的說明。
• 使用了子業務空間的 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. 配置環境變數 進入工作流程介面，找到 ，並將DASHSCOPE_API_KEY的值修改為您的API Key。
3. 測試生圖效果 單擊介面的运行按鈕即可產生作品。以文生圖工作流程輸入“小貓”為例，可以得到圖片。

   視頻產生工作流程會返回視頻的URL。

   文生視頻的時間一般在5分鐘以上，請耐心等待。

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

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

​

Q4：如何私人化部署 Dify？

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