API 속도 제한은 요청 빈도에 대한 제한입니다. 예를 들어, API는 분당 또는 일당 요청 수를 제한할 수 있습니다.

API는 또한 하나의 요청으로 보낼 수 있는 데이터의 양이나 단일 응답에서 API가 보내는 데이터의 양을 제한할 수도 있습니다.

속도 제한 문제 파악#

n8n 노드가 속도 제한에 도달하면 오류가 발생합니다. n8n은 노드 출력 패널에 오류 메시지를 표시합니다. 여기에는 서비스의 오류 메시지가 포함됩니다.

서비스로부터 오류 429(요청이 너무 많음)를 수신한 경우 오류 메시지는 The service is receiving too many requests from you입니다.

사용 중인 서비스의 속도 제한을 확인하려면 해당 서비스의 API 문서를 참조하세요.

통합의 속도 제한 처리#

n8n 통합에서 속도 제한을 처리하는 두 가지 방법이 있습니다: Retry On Fail 설정을 사용하거나, Loop Over Items와 Wait 노드를 조합하여 사용합니다:

• Retry On Fail은 API 요청 재시도 사이에 일시 정지를 추가합니다.
• Loop Over Items와 Wait를 사용하면 요청 데이터를 더 작은 청크로 분할하고 요청 사이에 일시 정지를 추가할 수 있습니다.

Retry On Fail 활성화#

Retry On Fail을 활성화하면 노드가 처음 실패할 경우 자동으로 요청을 다시 시도합니다.

1. 노드를 엽니다.
2. Settings를 선택합니다.
3. Retry On Fail 토글을 활성화합니다.
4. 재시도 설정을 구성합니다: 속도 제한을 극복하기 위해 사용하는 경우, **Wait Between Tries (ms)**를 속도 제한보다 높게 설정합니다. 예를 들어 사용 중인 API가 초당 하나의 요청을 허용하는 경우, 1초 대기를 허용하도록 **Wait Between Tries (ms)**를 1000으로 설정합니다.

Loop Over Items와 Wait 사용#

Loop Over Items 노드를 사용하여 입력 항목을 배치로 나누고, Wait 노드를 사용하여 각 요청 사이에 일시 정지를 도입합니다.

1. API를 호출하는 노드 앞에 Loop Over Items 노드를 추가합니다. 노드 구성 방법은 Loop Over Items를 참조하세요.
2. API를 호출하는 노드 뒤에 Wait 노드를 추가하고 Loop Over Items 노드에 다시 연결합니다. 노드 구성 방법은 Wait를 참조하세요.

예를 들어 OpenAI 사용 시 속도 제한을 처리하려면:

HTTP Request 노드의 속도 제한 처리#

HTTP Request 노드에는 속도 제한 및 대량 데이터를 처리하기 위한 내장 설정이 있습니다.

요청 배치 처리#

배치 처리 옵션을 사용하여 요청 크기를 줄이고 요청 사이에 일시 정지를 도입하면서 여러 요청을 보냅니다. 이것은 Loop Over Items와 Wait를 사용하는 것과 동일합니다.

1. HTTP Request 노드에서 Add Option > Batching을 선택합니다.
2. Items per Batch를 설정합니다: 각 요청에 포함할 입력 항목의 수입니다.
3. **Batch Interval (ms)**을 설정하여 요청 사이에 지연을 도입합니다. 예를 들어 사용 중인 API가 초당 하나의 요청을 허용하는 경우, 1초 대기를 허용하도록 **Wait Between Tries (ms)**를 1000으로 설정합니다.

결과 페이지 처리#

API는 단일 응답에서 처리할 수 있는 것보다 더 많은 데이터를 보내야 할 때 결과를 페이지로 나눕니다. HTTP Request 노드의 페이지 처리에 대한 자세한 내용은 HTTP Request node | Pagination을 참조하세요.