n8n 中文文档

处理速率限制

API[^1] 速率限制是对请求频率的限制。例如,API 可能会限制您每分钟或每天可以发出的请求数量。

API 还可以限制您在一个请求中可以发送的数据量,或者 API 在单个响应中发送的数据量。

识别速率限制问题

当 n8n 节点达到速率限制时,就会出错。 n8n 在节点输出面板中显示错误消息。这包括来自服务的错误消息。

如果 n8n 从服务收到错误 429(请求过多),则错误消息为 The service is receiving too many requests from you 该服务收到了太多来自您的请求。

要检查您正在使用的服务的速率限制,请参阅该服务的 API 文档。

处理集成的速率限制

有两种方法可以处理 n8n 集成中的速率限制:使用“失败时重试”设置,或使用 Loop Over Items 和 Wait 节点的组合:

  • 失败重试在 API 请求尝试之间添加了暂停。
  • 通过循环项目和等待,您可以将请求数据分成更小的块,以及在请求之间暂停。

启用失败重试

当您启用“失败重试”时,如果第一次失败,节点会自动再次尝试该请求。

  1. 打开节点。
  2. 选择Settings 设置。
  3. 启用 Retry On Fail 失败重试 切换。
  4. 配置重试设置。例如,如果 API 允许每秒一个请求,请将 Wait Between Tries (ms) 尝试之间等待(毫秒) 设置为 1000,以便在两次重试之间等待 1 秒。

Retry On Fail 的限制: Wait Between Tries 最多为 5000 毫秒(5 秒),Max Tries 最多为 5 次。HTTP Request 节点不会自动遵循 API 的 Retry-After 响应头。对于需要更长延迟的速率限制,请使用批处理,或将 Loop Over Items 与 Wait 节点结合使用来控制请求频率。

使用循环项目并等待

使用“循环项目”节点对输入项目进行批处理,并使用“等待”节点在每个请求之间引入暂停。

  1. 在调用API的节点前添加Loop Over Items节点。有关如何配置节点的信息,请参阅循环项目。
  2. 在调用 API 的节点后面添加 Wait 节点,并将其连接回 Loop Over Items 节点。有关如何配置节点的信息,请参阅 Wait。

例如,要处理使用 OpenAI 时的速率限制:

使用 Loop Over Items 和 Wait 节点控制向 OpenAI API 发送请求速率的工作流

HTTP请求节点中的处理速率限制

HTTP 请求节点具有用于处理速率限制和大量数据的内置设置。

批量请求

使用 Batching 选项控制节点在暂停前发送多少个请求。Batch Interval 设置控制批次之间的延迟。

  1. 在 HTTP 请求节点中,选择 Add Option 添加选项 > Batching 配料。
  2. 将 Items per Batch 每批次的项目 设置为每批处理的输入项数量。每个输入项都会生成一个单独的 HTTP 请求。
  3. 设置 Batch Interval (ms) 批次间隔(毫秒) 以在批次之间引入延迟。例如,将 Batch Interval (ms) 批次间隔(毫秒) 设置为 1000,以便在批次之间等待 1 秒。

对结果进行分页

当 API 需要发送的数据多于它们在单个响应中可以处理的数据时,会对结果进行分页。有关 HTTP 请求节点中分页的详细信息,请参阅 HTTP 请求节点 |分页。

[^1]:API 或应用程序编程接口提供对服务数据和功能的编程访问。 API 使软件更容易与外部系统交互。它们通常作为通过 Web 浏览器或 UI 访问的传统以用户为中心的界面的替代方案。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。