상태 폴링을 이용한 Replicate AI 콘텐츠 생성 - n8n 워크플로우

• AI 개발자: 비동기 Replicate 작업을 위한 안정적인 n8n 템플릿이 필요한 분.


• 콘텐츠 제작자: 사용자 정의 가능한 n8n 워크플로우를 사용하여 이미지 또는 콘텐츠 생성을 확장하려는 분.


• 자동화 엔지니어: n8n에 내장된 폴링 로직이 포함된 실무 투입 가능한 솔루션을 필요로 하는 분.


• Replicate 플랫폼 사용자: 기존 n8n 환경 내에서 원활한 통합을 원하는 분.

대규모 AI 결과물을 생성할 때는 비동기 처리가 필요한 경우가 많습니다. 즉, 요청을 제출한 후 작업이 완료될 때까지 API를 주기적으로 확인(폴링)해야 합니다. 이 복잡한 작업은 Replicate의 moicarmonas/2ndmoises_generator 모델과 특별히 연동되는 본 n8n 워크플로우가 전문적으로 관리합니다.

이 n8n 템플릿은 인증 처리, 다양한 생성 파라미터(프롬프트, 크기, 시드, 품질 등) 구성, 예측 요청 제출, 그리고 결정적으로 전용 n8n 노드 구성 요소를 사용하여 폴링 루프를 관리하는 완전하고 실무 투입 가능한 솔루션을 제공합니다. 이 워크플로우는 생성 성공 여부와 관계없이 명확하고 구조화된 JSON 응답을 보장하므로, n8n에서 외부 AI API를 활용하기 위한 필수 자동화 도구입니다.

이 n8n 워크플로우는 비동기 API 처리를 위해 안정적인 패턴을 따릅니다:

1. 트리거 및 설정: 프로세스는 Manual Trigger n8n 트리거로 시작됩니다. 초기 노드들(Set API Token 및 Set Other Parameters)은 Replicate API 키를 안전하게 삽입하고 AI 생성에 필요한 모든 파라미터(프롬프트, 이미지 설정 등)를 정의합니다.


2. 예측 요청: Create Other Prediction n8n 노드는 HTTP 요청을 사용하여 Replicate에서 생성 프로세스를 시작하고, 추적을 위한 고유한 예측 ID를 받습니다.


3. 로깅 및 초기 대기: 코드 n8n 노드가 요청 세부 정보를 로깅한 후, Wait 5s n8n 노드가 뒤따르며 폴링 시작 전에 짧은 지연 시간을 확보합니다.


4. 상태 폴링 루프: Check Status HTTP Request n8n 노드는 예측 ID를 사용하여 Replicate API를 쿼리하여 현재 작업 상태를 가져옵니다.


5. 조건부 라우팅: Is Complete? n8n 노드는 상태가 succeeded(성공)인지 확인합니다.

1. 최종 결과: 최종 Display Result n8n 노드는 성공 또는 오류 객체를 통합하여 명확한 출력을 제공합니다.

이 강력한 n8n 워크플로우를 배포하려면 다음 단계를 따르세요:

1. n8n 워크플로우 가져오기: 제공된 JSON 데이터를 복사하여 n8n 캔버스에서 '새로 만들기(New)' -> 'JSON에서 가져오기(Import from JSON)' 옵션을 사용하여 붙여넣으세요.


2. Replicate API 키: Replicate.com에서 API 토큰을 발급받으세요.


3. 자격 증명 설정: Set API Token n8n 노드를 찾으세요. 자리 표시자 값인 YOURREPLICATEAPI_TOKEN을 실제 Replicate API 키로 바꾸세요. 이 자격 증명이 외부에 노출되지 않도록 주의하세요.


4. 파라미터 사용자 지정: Set Other Parameters n8n 노드를 검토하세요. 생성 요구 사항에 맞게 prompt, width, height 및 기타 모델별 파라미터를 조정하세요. 이 n8n 노드에는 AI 모델에 필요한 모든 입력값이 들어 있습니다.


5. 활성화: n8n 워크플로우를 저장하고 활성화하세요. 자동화 테스트를 위해 'Manual Trigger' n8n 트리거를 클릭하여 실행하세요.

Manual Trigger (n8n 트리거): 전체 n8n 워크플로우 실행을 시작합니다. 주로 테스트용이거나 수동으로 워크플로우를 실행할 때 사용됩니다.
Set API Token (n8n 노드): 개인 Replicate API 키를 안전하게 저장하는 중요한 단계로, 인증을 위해 후속 HTTP 요청 노드에서 참조됩니다.
Set Other Parameters (n8n 노드): prompt, seed, aspectratio, outputformat을 포함하여 moicarmonas/2ndmoises_generator 모델에 필요한 모든 입력을 수집하고 구성합니다.
Create Other Prediction (HTTP Request n8n 노드): 초기 POST 요청을 Replicate API로 보내 비동기 AI 생성 프로세스를 시작합니다. 이전에 설정된 인증 토큰을 사용합니다.
Wait 5s / Wait 10s (n8n 노드): 비동기 폴링에 필요한 시간 지연을 구현하여 즉각적인 재확인을 방지하고 이 n8n 템플릿 내에서 API 속도 제한을 효과적으로 관리합니다.
Check Status (HTTP Request n8n 노드): 초기 요청에서 반환된 예측 ID를 사용하여 예측 작업의 상태를 주기적으로 확인합니다.

• Is Complete? / Has Failed? (If n8n 노드): 이 핵심 로직 n8n 노드들은 흐름을 제어하며, 작업 상태(성공, 실패 또는 처리 중)를 확인하여 결과 반환, 오류 보고 또는 상태 확인 재시도 여부를 결정합니다.