Replicate 폴링 루프를 사용한 비동기 AI 이미지 생성 - n8n 워크플로우

결과를 즉시 반환하지 않는 비동기 AI 작업을 자동화해야 하는 사용자
Replicate와 같이 오래 걸리는 API 서비스를 연동하기 위한 안정적인 n8n 템플릿을 찾는 개발자
콘텐츠 생성을 위해 AI 모델(특히 creativeathive/lemaar-door-mockedup)을 활용하는 기술 마케터 또는 디자이너
핵심 로직 흐름 제어를 보여주는 전문적인 n8n 워크플로우 예시를 찾는 모든 분

복잡한 AI 이미지 생성에는 종종 시간이 소요되므로, 초기 API 요청은 최종 결과물이 아닌 예측 ID만 반환합니다. 따라서 작업이 완료될 때까지 서비스로 반복적으로 '폴링(상태 확인)'해야 합니다. 이 특화된 n8n 워크플로우는 강력하고 자체 수정 기능이 있는 폴링 루프를 구현하여 이러한 문제를 해결합니다.

The automation starts with an n8n trigger, initializes the job with Replicate, and then enters a loop using the Wait and If n8n nodes. This loop ensures the workflow pauses (Wait node), checks the status (HTTP Request n8n node), and only proceeds when the generation is 'succeeded'. This powerful logic makes this n8n template highly reliable for handling external asynchronous tasks, a critical pattern for advanced n8n automation.

This n8n workflow executes through a structured sequence designed specifically for asynchronous API interactions:

1. 수동 시작: 워크플로우는 '실행 클릭 시(On clicking 'execute')' n8n 트리거로 시작되어 수동 테스트 및 실행이 가능합니다.


2. API 키 설정: 'API 키 설정(Set API Key)' n8n 노드는 필요한 Replicate API 키를 초기화하여 후속 단계의 인증을 보장합니다.


3. 예측 생성: HTTP 요청(HTTP Request) n8n 노드가 Replicate API로 POST 요청을 보내 지정된 모델(creativeathive/lemaar-door-mockedup)과 입력 파라미터(프롬프트, 시드 등)를 사용하여 AI 생성을 시작합니다.


4. ID 추출: '예측 ID 추출(Extract Prediction ID)' n8n 노드는 API 응답을 즉시 처리하여 폴링 프로세스에 필요한 고유 예측 ID를 추출하고 상태 확인을 위한 엔드포인트 URL을 구성합니다.


5. 폴링 시작: 워크플로우는 'Wait' n8n 노드로 이동하여 폴링 주기 동안 API에 과부하가 걸리는 것을 방지하기 위해 실행을 2초간 일시 중지합니다.


6. 상태 확인: '예측 상태 확인(Check Prediction Status)' HTTP 요청 n8n 노드는 추출된 URL과 API 키를 사용하여 AI 생성 작업의 상태를 쿼리합니다.


7. 루프 제어: '완료 여부 확인(Check If Complete)' If n8n 노드는 상태를 분석합니다. 상태가 'succeeded'이면 워크플로우가 결과 처리를 진행하고, 그렇지 않으면(예: 'processing', 'starting') 'Wait' 노드로 루프백하여 2초 대기 및 상태 확인을 다시 시작합니다. 이 폴링 로직이 n8n 워크플로우의 핵심 기능입니다.


8. 결과 처리: 작업이 완료되면 '결과 처리(Process Result)' n8n 노드는 생성된 이미지 URL, 완료 메트릭 및 기타 관련 메타데이터를 포함한 최종 출력 데이터를 추출합니다.

이 포괄적인 n8n 워크플로우를 배포하려면 다음 단계를 따르십시오:

1. n8n 워크플로우 가져오기: 제공된 JSON 코드를 복사하여 '워크플로우(Workflows)' 섹션에서 'JSON에서 가져오기(Import from JSON)' 버튼을 사용하여 n8n 인스턴스로 직접 가져옵니다.


2. Replicate 자격 증명 설정: Replicate API 키가 필요합니다. Replicate 계정 설정에서 해당 키를 발급받으십시오.


3. API 키 노드 구성: 가져온 워크플로우에서 'API 키 설정(Set API Key)' n8n 노드를 찾습니다. replicateapikey 할당 구성에서 플레이스홀더 값 YOURREPLICATEAPI_KEY를 실제 Replicate API 키로 바꿉니다.


4. 입력 프롬프트 구성: '예측 생성(Create Prediction)' n8n 노드를 찾습니다. JSON 본문을 편집하여 원하는 prompt 값을 설정하고 모델에 따라 seed, width, height 등의 입력을 조정합니다.


5. 활성화 및 테스트: n8n 워크플로우를 활성화하고 '워크플로우 실행(Execute Workflow)' 버튼을 클릭하여 전체 비동기 폴링 시퀀스를 테스트합니다.

이 n8n 워크플로우는 복잡한 로직을 관리하기 위해 다음과 같은 주요 n8n 노드 유형을 활용합니다:

실행 클릭 시(On clicking 'execute') (수동 트리거 n8n 트리거): 이 특정 n8n 워크플로우 템플릿의 시작점으로, 프로세스 수동 시작을 허용합니다.
API 키 설정(Set API Key) (Set n8n 노드): 후속 HTTP 요청 인증을 활성화하기 위해 필요한 Replicate API 키를 워크플로우 데이터 스트림에 안전하게 삽입하는 데 사용됩니다.
예측 생성(Create Prediction) (HTTP 요청 n8n 노드): 입력 프롬프트와 모델 구성을 보내 비동기 이미지 생성 작업을 시작하기 위해 Replicate API를 호출하는 역할을 합니다.
예측 ID 추출(Extract Prediction ID) (Code n8n 노드): 폴링 프로세스에 필요한 고유 ID를 추출하고 상태 확인을 위한 엔드포인트 URL을 생성하는 중요한 사용자 지정 코드 n8n 노드입니다.
Wait (Wait n8n 노드): 폴링 루프 내에 필요한 시간 지연(2초)을 구현하여 외부 API에 계속 요청을 보내는 것(해머링)을 방지하고 처리를 위한 시간을 제공합니다.
예측 상태 확인(Check Prediction Status) (HTTP 요청 n8n 노드): 예측 ID를 기반으로 Replicate 서비스 상태를 반복적으로 쿼리하는 폴링 메커니즘의 핵심입니다.
완료 여부 확인(Check If Complete) (If n8n 노드): n8n 워크플로우의 흐름 제어를 제공합니다. 상태가 'succeeded'인지 확인합니다. 참이면 워크플로우가 루프를 종료하고, 거짓이면 Wait 노드로 라우팅됩니다.
결과 처리(Process Result) (Code n8n 노드): 완료 시 실행되어 최종 이미지 출력 URL과 메타데이터를 정리하여 다운스트림에서 사용하도록 제공합니다.