在使用n8n进行AI工作流编排时,官方提供的AI节点目前仅支持Google PaLM、OpenAI、Cohere等国外模型,暂未包含智谱、文心一言、讯飞星火、通义千问等国产大模型。那么如何将n8n接入国产大模型教程呢?接下来将由站长百科为大家详细介绍。
若想在n8n中使用国产模型,有两种主要方法:
1、使用HTTP Request节点直接调用:但这种方式配置复杂,且无法与n8n内置的LangChain节点配合使用,限制了工作流的编排能力。
2、通过API转换工具接入:将国产模型API伪装成OpenAI API格式,从而可以使用n8n的OpenAI Chat Model节点,充分利用LangChain功能。
本教程将详细介绍第二种方法,即利用开源工具OneAPI实现国产大模型的接入。
一、用1Panel部署OneAPI
1、环境要求
一台已安装1Panel面板的服务器。
1Panel面板购买地址:点击直达
如果还没有独立服务器,建议去RAKsmart买一台,n8n只有运行在服务器上才能发挥最大功效。由于Workflow性能不是一直跑,建议配置:2vCPU/2GB RAM(非高并发场景)。
RAKsmart官网:点击直达。
1个已备案的域名(用于OneAPI访问)。域名购买平台推荐:Gname、NameCheap、Namesilo等。
2、安装OneAPI
(1)登录1Panel管理后台
(2)进入“应用商店”→“AI/大模型”→ 搜索“One API”
(3)点击“安装”按钮,在弹出的安装面板中:
- 保持所有默认设置(端口3000)
- 取消勾选“端口外部访问”
- 点击“确定”开始安装
3、配置反向代理
在1Panel后台,进入“网站”→“网站”→“创建网站”
配置如下:
- 网站类型:选择“反向代理”
- 主域名:填写为OneAPI准备的域名(例如:oneapi.example.com)
- 代号:输入”OneAPI”
- 代理地址:填写”http://localhost:3000/”
- 点击“确认”完成创建
4、配置HTTPS
(1)在网站列表中,点击刚刚创建的OneAPI域名
(2)进入“HTTPS”选项卡
(3)选择或创建域名的SSL证书
(4)点击“保存”启用HTTPS
5、验证安装
安装完成后,通过浏览器访问配置的域名(如https://oneapi.example.com),若能看到OneAPI登录界面,则表示安装成功。
初始管理员账号信息如下:
- 用户名:root
- 密码:123456
二、配置OneAPI
1、安全性设置
首先进行必要的安全配置,保护API密钥安全:
(1)登录OneAPI管理后台
(2)进入“设置”→“系统设置”
(3)修改管理员账号密码(建议使用16位以上随机密码)
(4)若不公开使用,取消“配置登录注册”中的所有允许注册选项
(5)建议启用CloudFlare Turnstile验证码(需在CloudFlare官网注册获取密钥)
(6)生产环境建议屏蔽搜索引擎索引并配置告警系统
2、配置模型渠道
以智谱大模型为例,配置上游API渠道:
(1)获取智谱API密钥
- 访问智谱AI开放平台(https://open.bigmodel.cn/)
- 注册并完成开发者认证
- 创建应用,获取API Key
(2)在OneAPI中添加渠道
进入OneAPI管理后台,点击“渠道”→“添加新的渠道”
按以下信息填写:
- 类型:选择“智谱 ChatGLM”
- 名称:自定义(如”Zhipu-GLM4″)
- 分组:自定义(如”domestic-models”)
- 模型:点击“填入相关模型”,手动添加”gpt-4″和”gpt-3.5-turbo”
- 模型重定向:
{
“gpt-3.5-turbo”: “glm-4”
}
- 密钥:填入从智谱获取的API Key
(3)点击“确定”完成配置
3、创建访问令牌
(1)进入OneAPI的“令牌”→“添加新的令牌”
(2)配置如下:
- 名称:自定义(如”n8n-access-token”)
- 模型范围:添加实际使用的模型(如”glm-4″)和伪装的模型名(如”gpt-3.5-turbo”)
(3)点击“确定”创建令牌
(4)在令牌列表中,点击“复制”按钮获取API Key
三、配置n8n连接
1、创建工作流
(1)打开n8n编辑器,创建新的工作流
(2)添加以下节点:
- Chat Trigger:用于触发对话
- Basic LLM Chain:语言模型链
- OpenAI Chat Model:用于连接OpenAI兼容API
2、配置OpenAI Chat Model节点
(1)双击“OpenAI Chat Model”节点
(2)点击“Credential”旁边的铅笔图标创建新凭证
(3)在弹出的配置窗口中:
- Name:自定义凭证名称(如”OneAPI-Zhipu”)
- API Key:粘贴在OneAPI中创建的令牌Key
(4)点击“保存”,忽略n8n提示的连接错误(因为这不是真正的OpenAI Key)
3、设置Base URL
(1)在“OpenAI Chat Model”节点中:
- 选择刚刚创建的凭证
- 展开“Options”选项
- 在“Base URL”字段中填写OneAPI的访问地址,格式为:”https://your-oneapi-domain.com/v1″ (例如:”https://oneapi.example.com/v1″)
(2)在“Model”字段中:
- 点击三个点按钮
- 选择“Refresh List”,应该能看到伪装的”gpt-3.5-turbo”模型
(3)保存整个工作流,退出编辑器后重新进入以确保Base URL生效
四、测试与验证
1、在n8n工作流编辑器中,点击“Chat”按钮
2、在对话窗口中输入测试内容
3、如果配置正确,n8n将通过OneAPI转发请求到智谱大模型,并返回响应结果
五、扩展与优化
1、接入其他国产模型
按照相同的方法,可以接入文心一言、讯飞星火、通义千问等其他国产大模型,只需在OneAPI中添加对应的渠道和模型配置。
2、直接指定模型名
如果需要接入多个国产模型,导致OpenAI模型名不够用,可以不进行模型重定向,而是在n8n中直接指定实际模型名:
(1)在“OpenAI Chat Model”节点的“Model”字段中,将模式切换为“Expression”
(2)手动输入实际模型名(如”glm-4″)
3、提高安全性
如果OneAPI和n8n部署在同一服务器上,建议配置OneAPI仅允许本地访问,进一步降低API Key泄露风险。












