GPT Image 2 / 2.5 + n8n: 제출 성공 후 이미지를 어떻게 받을까?

프롬프트 하나를 이미지 링크로 바꾸려면 n8n에서 제출과 조회 두 단계를 완료해야 합니다. 제출 후 API는 작업 번호를 반환하고, 이미지 생성이 완료되면 이 번호로 이미지 주소를 가져옵니다.

아래 워크플로는 후반부도 연결해 두었습니다. 한 번 제출하고, 몇 초 기다린 뒤, 같은 작업을 조회하여 이미지 URL을 받거나 실패 결과를 받을 때까지 반복합니다. 다운로드해서 가져온 후 자격 증명과 프롬프트를 채우면 이 흐름을 실행할 수 있습니다.

템플릿을 가져오고 Key를 자격 증명에 넣기

먼저 n8n 워크플로 JSON을 다운로드한 뒤 자신의 n8n에 가져오세요.

템플릿은 기본적으로 GPT Image 2.5 Flare 텍스트-이미지 생성을 호출하며, 출력은 1:1, 1K로 설정되어 있습니다. 모델 진입점과 현재 정보는 GPT Image 2.5 Flare에서 확인할 수 있습니다. 실행 전에 먼저 자신의 API Key를 연결하세요:

1. Credentials를 열고 Header Auth를 새로 만듭니다.
2. Name에 Authorization을 입력하고, Value에 Bearer YOUR_API_KEY를 입력한 뒤 자리 표시자를 자신의 Key로 바꿉니다. Bearer 뒤에 공백이 하나 있는 점에 주의하세요.
3. 저장한 후 Submit Task와 Get Task를 각각 열어 방금 만든 동일한 자격 증명을 선택합니다.

두 노드 모두 선택해야 합니다. 하나는 제출을, 하나는 조회를 담당합니다. Key는 Credentials에 통합 저장되며 두 요청 노드가 같은 자격 증명을 참조합니다.

첫 실행에서는 프롬프트만 변경

Workflow Input을 열고 prompt를 찾으세요. 템플릿에는 주황색 레트로 휴대용 게임기의 상품 이미지가 들어 있습니다. 아래 문장을 복사해도 됩니다:

A clean product photo of an orange retro handheld game console on a warm ivory studio surface, no text, no watermark.

다른 기본값은 그대로 두고 Execute Workflow를 클릭하세요. 템플릿은 5초마다 한 번씩 조회하며 최대 36회 조회합니다. 대기하는 동안 실행 기록에서 조회 노드가 반환한 작업 상태를 확인할 수 있습니다.

GPT Image 2로 바꾸려면 model을 gpt-image-2/text-to-image로 변경하세요. 기본 2.5 모델 값은 gpt-image-2.5-flare/text-to-image입니다. 이 두 텍스트-이미지 진입점은 템플릿의 prompt, aspect_ratio, resolution을 사용합니다.

Final Output에서 resultUrl 찾기

워크플로가 Final Output까지 진행되면 해당 출력 데이터를 여세요. 성공 시 resultUrl을 복사해 브라우저에서 열면 이미지를 볼 수 있고, 이 값을 이후 저장 또는 콘텐츠 노드에 전달할 수도 있습니다.

taskId도 함께 보관하세요. 이 값은 이번 생성에 대응하며, 나중에 진행 상황을 조회하거나 문제를 진단할 때 필요합니다. 템플릿은 결과 링크를 가져오는 역할만 하므로, 파일은 직접 다운로드하거나 자신의 저장 단계에 연결해야 합니다.

이미지를 받지 못했을 때는 먼저 어떤 상황인지 확인

fail은 서비스가 실패 상태를 반환한 경우이며, 오류 정보는 Final Output의 error에 있습니다. 구체적인 오류에 따라 입력 또는 계정 문제를 처리한 뒤 재생성 여부를 결정하세요.

timeout은 템플릿이 조회 횟수를 모두 채워 대기를 중단한 것이며, 서버 측 작업은 아직 끝나지 않았을 수 있습니다. 원래 taskId를 보관하고 별도의 HTTP Request 노드를 만들어 계속 조회하세요. 메서드는 GET, 주소는 https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID로 입력하고 끝의 작업 번호를 교체한 뒤 같은 Header Auth를 선택하세요. 이 GET 요청은 원래 작업의 최신 상태를 반환합니다.

HTTP Request 노드에서 바로 오류가 나서 Final Output까지 진행되지 않았다면 먼저 이 노드의 응답을 확인하세요. 401/403은 자격 증명과 권한, 400은 입력, 429는 속도 제한, 5xx는 서비스가 반환한 정보를 확인하세요. 특히 제출 단계에서 네트워크 오류가 발생했다면 작업이 이미 생성되었는지 먼저 확인하여 중복 제출을 피하세요.

먼저 웹 페이지에서 이미지를 생성한 뒤 자동화를 연결하고 싶다면 GPT Image 2.5 사용 튜토리얼을 참고하세요.