Dify 接入
如果你在 Dify 中使用 OpenAI 兼容模型路径，可以直接把 UniGateway 作为上游接入。
需要配置的内容
在 Dify 的 OpenAI 兼容模型配置中，填写：
- Base URL：
https://api.unigateway.ai/v1 - API Key：你的 UniGateway key
- Model name：
GET /v1/models返回的精确模型 ID
推荐配置顺序
- 先把 UniGateway 作为 OpenAI 兼容 provider 接入。
- 从
GET /v1/models中选择一个 canary 模型，先同步或手工录入。 - 先验证最基础的聊天工作流。
- 第一条路由稳定后，再增加更多模型。
能力映射建议
| Dify 里的工作负载 | 建议 |
|---|---|
| Chat 应用 | 先使用标准 chat-completions 兼容模型 |
| Agent 工作流 | 只启用已经验证过 tool use 的模型 |
| Embeddings | 确认端点和模型 ID 后再开启 |
| 图片或音频能力 | 单独验证，不要默认所有模型家族都支持 |
常见问题
| 问题 | 处理方式 |
|---|---|
| Provider 能连通但推理失败 | 重新核对实时模型列表中的精确模型 ID |
请求路径变成 /v1/v1/... | 去掉 Base URL 中重复的 /v1 |
| Chat 正常但其他功能失败 | 把每类端点当成独立上线项 |
| Dify 里的模型列表过期 | 模型目录变化后刷新或重新同步 |