Dify 是大模型应用开发平台，支持通过 OpenAI-API-compatible 模型供应商接入云信大模型 API 平台（简称 AIHub），可用于聊天助手、Agent、Chatflow、工作流和知识库等场景。

前提条件

在开始配置前，请确保已完成以下准备：

1. 已获取当前环境的 AIHUB_BASE_URL。
2. 已创建并启用 AIHUB_TOKEN（AIHub API 密钥/访问令牌）。
3. 当前访问令牌已授权目标 AIHub 模型。
4. 已通过 GET $AIHUB_BASE_URL/v1/models 确认模型可见。
5. 已准备 Dify 工作空间（可使用 Dify Cloud，或按 Dify 官方文档完成私有化部署）。

配置模型

1. 模型供应商配置。

   进入 Dify 工作空间后，点击右上角 头像>设置>模型供应商。

2. 添加 OpenAI-API-compatible 供应商。

   安装或启用 OpenAI-API-compatible 模型供应商，按以下示例填写：

Dify 配置项	说明
API endpoint URL	$AIHUB_BASE_URL/v1，例如 https://ai.yunxinapi.com/hub/v1
API Key	AIHUB_TOKEN，即 AIHub API 密钥/访问令牌
Model Name	AIHub 逻辑模型名称

• 如果 Dify 插件要求指定模型类型，请按实际用途选择 Chat/Text Generation/Embedding
• 向量模型应选择 AIHub 已授权的 Embeddings 逻辑模型。
• 如果模型供应商页面没有目标模型，不需要等待内置模型清单更新，手动填写 AIHub 逻辑模型名即可。

开始使用

• 聊天助手/Agent

  在模型设置中选择 AIHub provider 和目标逻辑模型，保存后在应用调试窗口发送测试消息即可验证。

• Chatflow/工作流

  在 LLM 节点中选择 AIHub provider。不同节点需要的模型能力不同。

  • 图像、音频、视频等任务型能力应使用 AIHub 对外开放的对应 API，不要假设所有能力都能通过同一个 LLM 节点调用。
  • 如果工作流需要调用 Vidu 任务型能力，可使用 HTTP 请求节点访问 AIHub 的 /vidu/v2 任务接口，并将 Authorization: Bearer <AIHUB_TOKEN> 放入请求头。

• 知识库

  知识库向量化需要 Embeddings 模型：

  1. 确认当前访问令牌可调用 /v1/embeddings 对应的逻辑模型。
  2. 在 Dify 中将其配置为 Embedding provider。

验证配置

1. 使用 curl 验证模型可用性。

   bashcurl "$AIHUB_BASE_URL/v1/models" \
     -H "Authorization: Bearer $AIHUB_TOKEN"
   

2. 在 Dify 中调试。

   Dify 调试成功后，前往 AIHub 控制台 查看请求日志，确认请求路径、模型名和用量记录符合预期。

常见问题

现象	排查方向
插件内置模型清单没有目标模型	使用 OpenAI-API-compatible provider 手动填写 AIHub 模型名称。
API Key 校验失败	API Key 应填写 AIHub 访问令牌（AIHUB_TOKEN）。
Embedding 配置失败	聊天模型不能作为向量模型；请使用已授权的 Embeddings 逻辑模型。
工作流节点调用多模态失败	确认该节点发出的协议是否匹配 AIHub 已开放 API；Vidu 任务类能力请使用 /vidu/v2 任务接口。