ComfyUI에서 GPT Image 2.5를 사용하려면 공식 파트너 노드와 Comfy 계정, 사용 가능한 크레딧을 준비하면 됩니다. Flare와 Sunburst는 원격 API에서 실행되므로 체크포인트 파일을 내려받아 모델 폴더에 넣는 과정은 없습니다. 공식 안내는 ComfyUI 0.35.0 이상을 요구하며, 생성과 편집에 사용할 네 가지 템플릿을 제공합니다. ComfyUI 한국어 공식 가이드
이미 로컬 이미지 모델을 쓰고 있었다면 가장 먼저 인증 방식을 확인하세요. PC에 ComfyUI가 설치되어 있다는 것과 원격 이미지 생성 비용이 결제되는 계정이 준비되어 있다는 것은 별개의 조건입니다. 이 글은 2026년 9월 21일 확인한 공식 문서와 공개 구현을 기준으로 하며, 유료 생성이나 특정 설치 환경을 직접 시험한 결과는 아닙니다.
노드를 찾기 전에 로그인과 잔액부터 확인하세요
ComfyUI의 Settings > User에서 Comfy 계정으로 로그인하고 Settings > Credits에서 잔액을 확인합니다. 파트너 노드는 0보다 큰 크레딧 잔액을 요구합니다. ChatGPT 유료 구독이나 OpenAI API 계정의 잔액이 있다고 해서 Comfy 크레딧이 자동으로 생기는 것은 아닙니다. 파트너 노드 계정 및 결제 안내
자신의 컴퓨터에서 직접 접속하는 경우와 LAN 주소 등 다른 주소로 접속하는 경우에는 로그인 설정이 달라질 수 있습니다. 공식 안내의 허용된 접속 환경 밖에서는 ComfyUI Account API Key를 사용하는 인증 방식을 확인하세요. 이 키는 OpenAI API 키도, 커스텀 노드를 배포할 때 쓰는 레지스트리 키도 아닙니다. 사내 서버나 원격 PC에 접속한다면 워크플로를 다시 만들기 전에 현재 접속 방식에 맞는 인증 절차부터 확인하는 편이 좋습니다.
| 가지고 있는 것 | 공식 GPT Image 2.5 파트너 노드와의 관계 |
|---|---|
| Comfy 계정과 크레딧 | 공식 파트너 노드 사용에 필요 |
| ComfyUI Account API Key | 해당 접속 환경에서 Comfy 계정 인증에 사용 |
| OpenAI API 키 | OpenAI 직접 호출용이며 Comfy 계정 키를 대신하지 않음 |
| 다른 API 서비스의 키 | 그 서비스 호출용이며 공식 노드에 그대로 대입할 수 없음 |
| ChatGPT 구독 | Comfy 크레딧이나 OpenAI API 결제와 별개 |
로그인과 잔액을 확인했다면 ComfyUI를 지원 버전으로 업데이트하고 공식 가이드에 있는 GPT Image 2.5 템플릿을 불러옵니다. 노드의 표시 이름은 OpenAI GPT Image 2.5, 내부 ID는 OpenAIGPTImageNodeV2입니다. 템플릿이나 노드가 보이지 않으면 설치한 릴리스와 코어 업데이트 상태를 확인하세요. 공식 노드를 쓰기 위해 이름이 비슷한 커뮤니티 플러그인을 임의로 설치할 필요는 없습니다.
첫 생성은 모델 하나와 Save Image만 연결합니다
빈 작업 공간에서 시작한다면 GPT Image 2.5 노드의 이미지 출력을 Save Image에 연결합니다. 공식 생성 템플릿을 불러왔다면 이 연결을 확인한 뒤 모델과 프롬프트를 설정하세요.
처음 확인할 설정 예시는 다음과 같습니다. 같은 조건으로 연결 상태를 점검하기 위한 예시이며, 모든 작업에 가장 좋은 품질 설정이라는 뜻은 아닙니다.
| 항목 | 시작 예시 |
|---|---|
| model | gpt-image-2.5-flare |
| prompt | “카페 신메뉴 소개에 쓸 이미지. 밝은 나무 테이블 위에 아이스 라테 한 잔을 놓고, 오른쪽에는 제목을 넣을 공간을 남겨 주세요. 글자는 넣지 마세요.” |
| size | 1024x1024 |
| quality | medium |
| n | 1 |
| 출력 연결 | Save Image |
현재 노드는 low, medium, high, xhigh, max 품질 옵션을 노출합니다. OpenAI 직접 API에서 보았던 옵션을 ComfyUI에도 모두 입력할 수 있다고 가정하지 말고, 설치된 노드의 실제 선택지를 사용하세요. 참고 이미지를 연결하지 않은 요청은 생성 경로로, 참고 이미지를 연결한 요청은 편집 경로로 처리됩니다. 공식 노드 구현
Flare와 Sunburst는 둘 다 이미지 생성과 편집을 지원합니다. 여러 시안을 빠르게 만드는 작업이면 Flare, 기존 이미지의 세부 수정이 중요하면 Sunburst를 먼저 비교할 이유가 있습니다. 이는 공식 제품 설명에 따른 출발점이며 작업별 품질 순위를 측정한 결과는 아닙니다. 더 자세한 선택 기준은 Flare와 Sunburst 비교를 참고하세요.
실행 뒤에는 노드의 오류 유무만 보지 말고 Save Image까지 결과가 도착했는지, 저장된 파일이 실제로 열리는지 확인합니다. 원격 모델 호출이 성공했더라도 출력 노드가 연결되지 않았거나 저장 단계에 문제가 있으면 원하는 파일을 얻지 못할 수 있습니다.
참고 이미지는 연결하고, 마스크는 바꿀 곳만 칠하세요
상품 사진의 배경을 바꾸는 경우를 생각해 보겠습니다. 새 이미지를 생성하는 프롬프트만 쓰면 원래 상품의 형태가 달라질 수 있으므로, 원본을 Load Image로 불러와 GPT Image 2.5 노드의 이미지 입력에 연결합니다. 프롬프트에는 바꿀 부분과 유지할 부분을 함께 적습니다.
“배경을 따뜻한 크림색 스튜디오로 바꿔 주세요. 텀블러의 모양, 뚜껑, 손잡이와 로고는 그대로 유지하고 바닥 그림자는 새 배경에 맞춰 주세요.
현재 공식 구현은 참고 이미지를 최대 16장까지 받습니다. 다만 마스크를 사용하는 요청에는 입력 이미지가 정확히 한 장이어야 합니다. 여러 장을 연결해 둔 상태에서 부분 편집을 추가했다면, 우선 이미지 입력을 한 장으로 정리하세요. 참고 이미지와 마스크 처리 코드
ComfyUI 마스크에서는 흰색이 편집할 영역입니다. 배경을 바꾸려면 배경을 흰색으로 칠하고 상품은 보호할 영역으로 남깁니다. Images API 문서에서 투명한 영역을 편집한다고 읽었다면 혼동할 수 있지만, 공식 노드는 ComfyUI 마스크를 API가 받는 알파 값으로 변환합니다. 사용자가 API 설명에 맞추겠다며 ComfyUI 마스크를 임의로 한 번 더 반전할 필요는 없습니다.
위 그림은 편집할 영역을 설명하기 위한 예시이며, 두 모델을 실행해 얻은 비교 결과가 아닙니다.
마스크를 연결해도 나머지 부분이 픽셀 단위로 완전히 고정되는 것은 아닙니다. 결과에서 바꾸려던 배경이 바뀌었는지 확인한 다음, 로고·모서리·손잡이처럼 유지해야 할 부분을 원본과 비교하세요. 부분 편집이 성공했는지와 상품 이미지를 그대로 납품할 수 있는지는 별도로 판단해야 합니다.
참고 이미지는 현재 구현에서 업로드 전에 면적이 2048×2048픽셀 이하가 되도록 축소됩니다. 큰 원본을 넣었다는 사실만으로 모든 미세한 글자와 질감이 원본 해상도 그대로 전달된다고 볼 수 없습니다. 세부 보존이 중요하다면 최종 출력에서 해당 부분을 확대 확인하세요.
크기는 가로·세로를 함께 계산해야 합니다
직접 크기를 입력할 때는 숫자가 입력 칸에 들어간다는 것만으로 유효한 요청이 되지 않습니다. 현재 노드는 아래 조건을 함께 검사합니다. 크기 검증 구현
- 가로와 세로는 각각 16의 배수여야 합니다.
- 가장 긴 변은 3,840픽셀 이하여야 합니다.
- 긴 변과 짧은 변의 비율은 3:1 이하여야 합니다.
- 전체 면적은 655,360~8,294,400픽셀이어야 합니다.
- 크기 입력 UI의 최소 변 길이는 480픽셀입니다.
예를 들어 1024×1024는 1,048,576픽셀로 조건에 들어갑니다. 3840×2160은 8,294,400픽셀로 면적 상한에 해당하고, 공식 노드에도 이 크기의 프리셋이 있습니다. 반면 3840×3840은 두 변이 각각 최대 길이를 넘지 않더라도 면적이 14,745,600픽셀이므로 허용되지 않습니다. 480×480도 입력 칸의 최솟값을 충족하지만 면적은 230,400픽셀로 하한보다 작습니다.
“4K 지원”이라는 설명만 보고 임의의 정사각형 크기를 입력하기보다, 먼저 제공되는 프리셋으로 생성한 뒤 필요한 비율로 확장하는 편이 문제를 찾기 쉽습니다. 저장 후 리사이즈나 합성 노드를 추가했다면 그 단계에는 로컬 CPU·GPU 자원이 필요할 수 있습니다. GPT Image 2.5 생성 자체가 원격이라는 사실이 전체 워크플로의 로컬 연산을 없애 주지는 않습니다.
seed를 고정해도 같은 결과를 보장하지 않습니다
현재 GPT Image 2.5 공식 노드의 seed는 백엔드에서 재현 가능한 생성값으로 구현되어 있지 않습니다. 로컬 확산 모델을 쓸 때처럼 같은 seed와 같은 프롬프트로 동일한 이미지를 다시 만들 수 있다고 가정하면 안 됩니다. seed 처리에 대한 소스 설명
선택한 결과를 이어서 수정하려면 seed만 적어 두는 대신 결과 파일 자체를 보관하고 다음 편집의 참고 이미지로 사용하세요. 모델 ID, 프롬프트, 크기, 품질과 원본 이미지도 함께 남기면 어떤 조건에서 생성했는지 추적할 수 있습니다. 조건을 기록하면 비교에는 도움이 되지만, 다음 호출의 픽셀까지 같아진다는 뜻은 아닙니다.
자주 막히는 상황을 구분하기
| 상황 | 확인할 내용 |
|---|---|
| 템플릿을 열었는데 노드가 없음 | ComfyUI 버전과 코어 업데이트, 설치 릴리스의 해당 노드 포함 여부 |
| 인증 또는 잔액 오류 | Comfy 계정 로그인, Credits 잔액, 접속 환경에 맞는 Account API Key 설정 |
| 마스크 편집이 거절됨 | 참고 이미지가 한 장인지, 이미지·마스크 입력이 연결됐는지 |
| 사용자 지정 크기가 거절됨 | 16의 배수, 변 길이, 비율, 전체 면적을 함께 계산 |
| 같은 seed인데 그림이 달라짐 | 해당 노드의 seed가 결정적 재현을 지원하지 않는다는 점 |
| 결과 미리보기는 있는데 파일이 없음 | Save Image 연결과 해당 출력 단계의 실행 결과 |
다른 API 서비스의 키를 공식 노드에 넣고 싶다면, 먼저 노드에 그런 연결 설정이 있는지 확인해야 합니다. 현재 공식 구현은 Comfy 인증을 사용해 이미지 생성·편집 프록시를 호출하며 임의의 base URL을 넣는 공개 입력을 제공하지 않습니다. OpenAI와 요청 형식이 호환되는 서비스라고 해서 공식 파트너 노드의 인증도 바꿔 쓸 수 있는 것은 아닙니다.
n8n에서 ComfyUI 워크플로를 실행할 계획이라면 이전 커뮤니티 노드 예제의 JSON만 가져와 바로 운영하지 마세요. 워크플로 요청 접수, 파트너 노드의 계정 인증, 생성 완료 확인, 이미지 파일 회수까지 각각 확인해야 합니다. 고정 시간만 기다린 뒤 이미지를 가져오는 방식은 요청을 받았다는 사실과 생성이 끝났다는 사실을 구별하지 못합니다. 먼저 ComfyUI 안에서 한 장의 생성과 저장을 확인하고, 그다음 외부 자동화 연결을 검증하는 순서가 문제를 좁히는 데 도움이 됩니다.
