接入指南

接入 Dify

在 Dify 模型供应商中配置 UWCode API Base，让 AI 应用统一通过企业网关调用模型。

接入 Dify

Dify 适合企业构建 AI 应用、工作流和智能体。将 Dify 的模型供应商接入 UWCode 后，应用内的模型调用可以统一进入 UWCode 网关，并按应用、项目或服务账号统计用量。

推荐接入方式

对于企业使用 Dify 调用模型的场景，推荐在 Dify 的 模型供应商 中配置 OpenAI Provider，并把 API Base 指向 UWCode。

Dify 字段建议值
API Keyuwc-xxxxxxxx
API Basehttps://api.uwcode.com/v1
Validate Model选择一个 UWCode 已授权模型
API Protocol按模型能力选择 Chat Completions 或 Responses

配置步骤

  1. 进入 Dify 工作区。
  2. 打开 Settings / Model Provider。
  3. 选择 OpenAI Provider，进入凭据配置。
  4. 填写 UWCode 分配给 Dify 的服务账号 Key。
  5. 将 API Base 设置为 https://api.uwcode.com/v1 或企业私有化部署地址。
  6. 设置验证模型，例如 gpt-4o-mini 或企业控制台提供的模型 ID。
  7. 保存后在 Dify 应用中选择该模型供应商。

应用侧建议

  • 为 Dify 单独创建服务账号 Key，避免与员工开发工具共用。
  • 按应用或工作流拆分 Key，便于在 UWCode 中区分业务系统用量。
  • 对生产应用设置独立预算、并发和失败率监控。
  • 如果 Dify 使用私有化部署，优先通过内网域名访问 UWCode 私有化网关。

验证接入

  1. 在 Dify 中创建一个测试 Chatflow 或 Chatbot。
  2. 选择已配置 UWCode 的 OpenAI Provider。
  3. 发送一次测试消息。
  4. 在 UWCode 控制台按 Dify 服务账号 Key 查看调用日志。
curl https://api.uwcode.com/v1/chat/completions \
  -H "Authorization: Bearer uwc-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Dify 接入测试"}]}'

关于 Dify OpenAI-compatible 插件

Dify 官方插件中还包含将 Dify 应用暴露为 OpenAI-compatible endpoint 的能力。该方向适用于“外部系统调用 Dify 应用”，不是 Dify 调用 UWCode 模型的主要路径。

企业常见接入关系如下：

  • Dify 调用模型：在 Dify 模型供应商中配置 UWCode API Base。
  • 外部系统调用 Dify 应用：使用 Dify OpenAI-compatible Endpoint 插件。

常见问题

  • 凭据验证失败：确认 API Base 使用 /v1 结尾，并确认验证模型在 UWCode 中已授权。
  • Dify 应用可用但 UWCode 无日志：确认应用实际选择的是配置了 UWCode 的 Provider，而不是 Dify 内置试用模型。
  • Embedding 或 TTS 不可用：确认对应模型类型在 UWCode 和 Dify Provider 中均已启用。
  • 私有化部署访问失败：检查 Dify 容器网络是否可访问 UWCode 内网域名和证书链。

官方依据