n8n 接入
通过 OpenAI 兼容节点或 HTTP Request 节点在 n8n 中使用 UniGateway。
前置条件
- n8n 实例已运行
- 已获取 UniGateway API Key
- 已通过
GET /v1/models获取可用模型 ID
集成方式
| 方式 | 适用情况 |
|---|---|
| OpenAI / Chat OpenAI 节点 | n8n 版本支持你需要的设置 |
| HTTP Request 节点 | 需要对 URL、请求头和请求体做完全控制 |
配置
先用一条非流式聊天请求确认连接正常，再在已成功的流程中添加 embeddings、responses 或图像等其他端点。
测试环境和生产环境的凭证需分开配置。
注意事项
| 方面 | 说明 |
|---|---|
| 凭证管理 | 测试环境和生产环境使用不同 API Key |
| 节点版本 | n8n 升级后重新检查 OpenAI 节点行为 |
| HTTP Request 退路 | 当内置节点缺少某些端点行为时使用 |
| 错误处理 | 对 429 和 5xx 配置工作流级退避重试 |
常见问题
| 问题 | 处理方式 |
|---|---|
| 节点鉴权成功但请求失败 | 核对端点 URL、模型 ID 和请求族 |
| 内置节点缺少某项能力 | 改用 HTTP Request 节点处理该端点 |
| 一个工作流正常，另一个失败 | 检查缓存凭据或硬编码模型 ID |
| 重试导致大量重复执行 | 在工作流中设置重试次数上限和退避间隔 |