Dify 接入
将 UniGateway 添加为 Dify 中的 OpenAI 兼容模型 Provider。
前置条件
- Dify 实例已运行
- 已获取 UniGateway API Key
配置步骤
在 Dify 后台 设置 > 模型供应商，添加 OpenAI 兼容 Provider：
| 字段 | 值 |
|---|---|
| Base URL | https://api.unigateway.ai/v1 |
| API Key | 你的 UniGateway Key |
| 模型名称 | GET /v1/models 返回的精确 ID |
不要在 Base URL 末尾重复
/v1，否则请求会命中/v1/v1/...导致失败。
验证
发送一条简短测试消息确认连接成功。
curl https://api.unigateway.ai/v1/models \
-H "Authorization: Bearer $UNIGATEWAY_API_KEY"
能力映射
| 工作负载 | 推荐 |
|---|---|
| 聊天应用 | 标准聊天补全模型 |
| 自动化工作流 | 已验证支持工具调用的模型 |
| 嵌入向量 | text-embedding-3-small 或等效模型 |
| 图片 / 音频 | 单独验证 |
常见问题
| 问题 | 处理方式 |
|---|---|
| Provider 连通但推理失败 | 从 GET /v1/models 确认模型 ID |
请求命中 /v1/v1/... | 去掉 Base URL 末尾重复的 /v1 |
| 部分功能不稳定 | 将每个接口族作为独立验证项 |