n8n

n8n

公平代码工作流自动化工具,内置 AI 节点,支持 400+ 集成

简介

n8n 是一款工作流自动化平台,原生支持 AI 节点。其 OpenAI 集成支持自定义 Base URL,因此将其指向 TokenMix 的 OpenAI 兼容接口后,即可在 n8n 的所有 AI 节点中使用任意 TokenMix 模型,无需修改代码。

前置条件

推荐使用 Docker 自托管 n8n:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

浏览器访问 http://localhost:5678 完成初始设置。

同时需要 TokenMix API Key:在 tokenmix.ai → 控制台 → API Keys 中创建。

配置步骤

步骤 1 — 打开凭据管理

在 n8n 侧边栏,点击 凭据添加凭据 → 搜索 OpenAI

步骤 2 — 填写 OpenAI 凭据

字段
API Key 你的 TokenMix 密钥(sk-tm-…
Base URL https://api.tokenmix.ai/v1
Organization ID 留空

点击 保存,n8n 会自动测试凭据。

步骤 3 — 在 AI 节点中使用凭据

在工作流中添加 AI AgentLLM Chain 或任意 OpenAI 驱动的节点。在节点设置中选择刚创建的凭据,然后填写模型名称(如 gpt-5.4claude-sonnet-4.6deepseek-v4-pro)。

步骤 4 — 运行并验证

执行工作流,检查节点输出是否返回正常内容。也可在 TokenMix 控制台 → 使用记录 中确认请求已被记录。

验证

点击 测试工作流 按钮手动触发一次运行。节点输出正常即说明 TokenMix 路由已生效。

常见问题

Q: OpenAI 节点返回 404「model not found」错误。 A: 检查模型名称是否与 TokenMix 模型页面显示的 short_id 完全一致(如应填 gpt-5.4 而非 gpt-5)。n8n v2 AI 节点直接使用节点设置中的模型名称。

Q: 我使用的是旧版 n8n,OpenAI 凭据中没有 Base URL 字段。 A: 将 n8n 升级到最新版本。或改用 HTTP Request 节点直接调用 https://api.tokenmix.ai/v1/chat/completions,在请求头中添加 Authorization: Bearer sk-tm-xxx,兼容所有 n8n 版本。

Q: 不同工作流能使用不同模型吗? A: 可以。所有工作流共用同一个凭据(相同 Base URL 和 API Key),只在各节点设置中选择不同的模型名称即可。