Flowise 接入
通过带自定义 base URL 的 ChatOpenAI 路径，可以把 UniGateway 接入 Flowise。
需要配置的内容
Flowise 官方文档明确说明，ChatOpenAI 支持自定义 base URL 和 headers。
- Credential API key：你的 UniGateway key
- Base path / base URL：
https://api.unigateway.ai/v1 - Model name：
GET /v1/models返回的精确模型 ID
如果内置 ChatOpenAI 节点没有你需要的模型名，可以改用 ChatOpenAI Custom。
推荐配置顺序
- 在 flow 里拖入
ChatOpenAI节点。 - 用 UniGateway key 创建一个新的 credential。
- 打开
Additional Parameters。 - 把 base path 设置为
https://api.unigateway.ai/v1。 - 先用一个稳定模型 ID 跑通一次非流式聊天。
- 基础路径确认可用后，再增加图片、tools 或自定义模型。
运行建议
| 项目 | 建议 |
|---|---|
| Base path | 先用直连 /v1/models 验证完整路径 |
| ChatOpenAI Custom | 当普通节点还不支持你的模型名时，直接切到它 |
| 图片上传 | 把它当成独立兼容项，不要混在普通文本聊天里默认通过 |
| Flow 推广 | 先保留一个 canary chatflow，再复制到更多流程 |
常见失败场景
| 问题 | 处理方式 |
|---|---|
| Credential 正常，但推理失败 | 重新检查 base path 和精确模型 ID |
| 普通 ChatOpenAI 节点选不到模型 | 改用 ChatOpenAI Custom |
| 文本正常，图片上传失败 | 单独验证多模态支持 |
| 重试造成重复执行 | 把重试预算放在 workflow 层，而不是盲目叠节点重试 |