处理速率限制
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 请求尝试之间添加了暂停。
- 通过循环项目和等待,您可以将请求数据分成更小的块,以及在请求之间暂停。
启用失败重试
当您启用“失败重试”时,如果第一次失败,节点会自动再次尝试该请求。
- 打开节点。
- 选择Settings 设置。
- 启用 Retry On Fail 失败重试 切换。
- 配置重试设置。例如,如果 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 节点结合使用来控制请求频率。
使用循环项目并等待
使用“循环项目”节点对输入项目进行批处理,并使用“等待”节点在每个请求之间引入暂停。
- 在调用API的节点前添加Loop Over Items节点。有关如何配置节点的信息,请参阅循环项目。
- 在调用 API 的节点后面添加 Wait 节点,并将其连接回 Loop Over Items 节点。有关如何配置节点的信息,请参阅 Wait。
例如,要处理使用 OpenAI 时的速率限制:

HTTP请求节点中的处理速率限制
HTTP 请求节点具有用于处理速率限制和大量数据的内置设置。
批量请求
使用 Batching 选项控制节点在暂停前发送多少个请求。Batch Interval 设置控制批次之间的延迟。
- 在 HTTP 请求节点中,选择 Add Option 添加选项 > Batching 配料。
- 将 Items per Batch 每批次的项目 设置为每批处理的输入项数量。每个输入项都会生成一个单独的 HTTP 请求。
- 设置 Batch Interval (ms) 批次间隔(毫秒) 以在批次之间引入延迟。例如,将 Batch Interval (ms) 批次间隔(毫秒) 设置为
1000,以便在批次之间等待 1 秒。
对结果进行分页
当 API 需要发送的数据多于它们在单个响应中可以处理的数据时,会对结果进行分页。有关 HTTP 请求节点中分页的详细信息,请参阅 HTTP 请求节点 |分页。
[^1]:API 或应用程序编程接口提供对服务数据和功能的编程访问。 API 使软件更容易与外部系统交互。它们通常作为通过 Web 浏览器或 UI 访问的传统以用户为中心的界面的替代方案。