通过 OpenAI 兼容节点或 HTTP Request 节点把 UniGateway 接入 n8n。
当你的 n8n 版本暴露了所需的 OpenAI 兼容配置时，可以直接用内置节点接 UniGateway；如果不够灵活，就退回到通用 HTTP Request 节点。
接入方式#
| 方式 | 适用场景 |
|---|
| OpenAI / Chat OpenAI / Embeddings OpenAI 节点 | 当前 n8n 版本和部署方式支持你需要的 OpenAI 兼容配置 |
| HTTP Request 节点 | 你需要完全控制 URL、请求头和请求体 |
最小配置#
- API key：你的 UniGateway bearer token
- Base URL：
https://api.unigateway.ai/v1
- Model ID：
GET /v1/models 返回的精确值
推荐上线顺序#
- 先跑通一个最简单的非流式聊天请求。
- 确认你选择的 credential 路径或节点路径真的打到了 UniGateway。
- 第一条工作流稳定后，再增加 embeddings、responses、图片或音频能力。
- 模型目录变更后重新同步模型 ID，不要默认它永远不变。
运行建议#
| 项目 | 建议 |
|---|
| 凭证管理 | 在 n8n 里把 production 和 staging key 分开存放 |
| OpenAI 节点版本 | n8n 升级后要重新检查节点行为，API 支持会持续演进 |
| HTTP Request 回退 | 当内置节点不支持某类端点行为时，直接切到 HTTP Request |
| 错误处理 | 把 429 和 5xx 的退避重试写进工作流逻辑，而不是做无限立即重试 |
常见失败场景#
| 问题 | 处理方式 |
|---|
| 节点能鉴权但请求失败 | 核对精确端点 URL、模型 ID 和请求家族 |
| 内置节点缺少某项能力 | 对该端点族改用 HTTP Request 节点 |
| 一个工作流能跑，另一个不能 | 检查缓存凭证、重复节点或硬编码模型 ID |
| 重试导致大量重复执行 | 在工作流层设置重试预算和退避 |