跳转到主要内容
千问AI平台 home page
文档
客户端与工具

Dify

低代码 LLM 应用平台

Dify 是一个通过可视化工作流构建 LLM 应用的低代码平台。将其连接到千问AI平台的按量付费 API，即可创建由 Qwen 模型驱动的聊天助手、智能体和知识库。

前提条件

您需要获取 API Key，并确保已开通千问AI平台的模型服务。
Dify 属于工作流/自动化平台，不支持使用 Token Plan 个人版、Token Plan 团队版接入。这些套餐仅限在 AI 编程工具和 OpenClaw 类型 Agent 中使用，详见不支持的工具类型。在 Dify 中请使用按量付费的 API Key。将套餐 API Key 用于允许范围之外的调用将被视为违规或滥用，可能会导致订阅被暂停或 API Key 被封禁。

1. 配置模型

1.1. 安装模型供应商

前往 Dify 市场，在模型下找到通义千问并安装最新版插件。
  • 千问插件非千问AI平台提供，由 Dify 官方维护。若安装最新版插件报错，可尝试安装较早版本。
  • 使用千问AI平台提供的 DeepSeek 模型也请使用通义千问插件。

1.2. 配置 API Key

单击页面右上角的头像-设置，在模型供应商处找到通义千问卡片，点击设置。在卡片的 API-KEY 设置界面填入 API Key，并设置使用国际端点为否。
若 API Key 配置过程报错：Invalid API-key provided，请参见 1.1. 安装模型供应商 中关于插件版本的说明。
20251127172111

1.3. 选择模型

单击通义千问卡片中的显示模型，打开您需要使用的模型开关。
若插件内暂未包含最新版千问模型，可尝试安装 OpenAI-API-compatible 插件，在插件设置中的 API endpoint URL 填入 https://maas.qianwenaiapi.com/compatible-mode/v1。

2. 开始使用

Dify 具有多种大模型应用类型，请选择您使用的类型进行参考。
  • 聊天助手/Agent
  • Chatflow/工作流
  • 知识库
  1. 创建一个聊天助手或Agent 在工作室单击创建空白应用，在新手适用中创建一个聊天助手或Agent并进入。
  2. 选择模型 在应用页面右上角可以选择模型，以通义千问下的 qwen-plus-latest(Qwen3) 为例，打开思考模式并设置为True。
  3. 对话测试 输入“你是谁”，模型会在思考后进行回答。 您也可以使用视觉理解模型针对图片进行提问。在选择视觉模型后界面左侧会出现视觉开关，打开即可在右侧的对话框输入图片。

常见问题

Q1：在千问插件内配置 API Key 报错？

A：有以下常见原因：
  • 最新版插件性能可能不稳定，请参见 1.1. 安装模型供应商 中关于插件版本的说明。
  • 端点设置错误，请确认使用国际端点已设置为否。

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

A：以上模型均不支持直接在 Dify 上配置，您可通过 Chatflow 或工作流的 HTTP 节点接入，接入细节请参见文档中的 Curl 命令。
为了降低HTTP节点的超时风险，建议您通过流式输出方式调用。

Q3：如何使用万相模型？

A：Dify 没有提供万相模型相关的插件，通过Dify的Chatflow/工作流的节点可达到文生图/视频的功能。请参考以下步骤：
  1. 下载并导入工作流模板 下载我们写好的模板：万相-文生图Demo.yml或 万相-文生视频Demo.yml，在工作室单击导入DSL文件并选择下载的模板文件。
  2. 配置环境变量 进入工作流界面，找到 image.png，并将DASHSCOPE_API_KEY的值修改为您的API Key。
  3. 测试生图效果 单击界面的运行按钮即可生成作品。以文生图工作流输入“小猫”为例，可以得到图片。
    视频生成工作流会返回视频的URL。
    文生视频的时间一般在5分钟以上，请耐心等待。
  4. 发布为工具（可选） 为了在其它大模型应用中使用万相的文生图/视频功能，您可以在界面右上方单击发布并选择发布为工具。
模板使用的模型为wanx2.1-t2i-turbo（文生图）/wanx2.1-t2v-turbo（文生视频）。您可以在STEP1节点修改模型。