指南

n8n 配置

配置 n8n 工作流自动化平台使用本平台

已支持已验证

Use TokenHub as the OpenAI-compatible model provider inside n8n workflows and agents.

什么是 n8n

n8n 是一款开源的工作流自动化平台，支持通过 HTTP Request 节点调用外部 API，可用于构建 AI 工作流。

系统要求

快速开始

1. 创建工作流

在 n8n 中创建一个新的工作流。

2. 添加 HTTP Request 节点

添加一个 HTTP Request 节点，配置如下：

#### Chat Completions 示例

配置项	值
Method	`POST`
URL	`https://tokenhub.local/v1/chat/completions`
Authentication	`Header Auth`
Header Name	`Authorization`
Header Value	`Bearer sk-your-api-key`

#### 请求体（Body）

选择 JSON 格式：

json

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "max_tokens": 100
}

3. 图片生成示例

配置项	值
Method	`POST`
URL	`https://tokenhub.local/v1/images/generations`
Authentication	`Header Auth`
Header Name	`Authorization`
Header Value	`Bearer sk-your-api-key`

#### 请求体

json

{
  "model": "gpt-image-2",
  "prompt": "A white siamese cat",
  "size": "1024x1024"
}

4. 使用响应数据

HTTP Request 节点的响应可以通过表达式在其他节点中引用：

text

{{ $json.choices[0].message.content }}

高级用法

流式输出

设置 "stream": true 可以启用流式输出，配合 n8n 的循环节点逐条处理响应。

多模型串联

在工作流中使用多个 HTTP Request 节点，分别调用不同模型，实现复杂的多步骤 AI 工作流。

常见问题

请求返回 401？

检查 Authorization Header 格式是否为 Bearer sk-your-api-key，注意 Bearer 后有空格。

请求超时？

n8n 默认请求超时为 30 秒，可在节点设置中调整超时时间。

当前公开文档仅覆盖已验证的 OpenAI 兼容接口；其他扩展能力仍需单独验证。

Trae

Dify