Luck GPT-Image 2 - ComfyUI 노드

개요

Comfyui-Luck-gpt2.0는 커뮤니티 사용자 luckdvr가 기여한 ComfyUI 커스텀 노드 팩입니다. 이를 통해 ComfyUI 안에서 APIYI의 두 GPT 이미지 모델인 **공식 gpt-image-2**과 **역공학한 gpt-image-2-all**을 직접 호출할 수 있습니다. 두 노드는 역할 분담이 분명합니다. 전자는 세밀한 매개변수(해상도, 품질, 마스크, 다중 참조)에 중점을 두고, 후자는 ChatGPT와의 동등한 대화형 이미지 경험을 제공하며 내장 타임아웃/재시도를 지원합니다. 생산 환경 워크플로에 적합합니다.

프로젝트 정보

🔗 소스: github.com/luckdvr/Comfyui-Luck-gpt2.0
📜 라이선스: Apache-2.0
👤 작성자: luckdvr
⭐ 커뮤니티 기여작이며, APIYI를 위해 제작되었습니다

작성자의 다른 노드 팩과 어떻게 구분합니까?luckdvr는 APIYI용으로 두 개의 ComfyUI 노드 팩을 기여합니다.

Luck Nano Banana Pro: Gemini 계열(gemini-3-pro-image-preview / gemini-3.1-flash-image-preview)을 호출합니다. 14개의 참조 이미지와 엔지니어링급 재시도/타임아웃을 중점으로 합니다
Luck GPT-Image 2 (이 페이지): OpenAI 계열(gpt-image-2 / gpt-image-2-all)을 호출합니다. 이중 엔드포인트 전환(chat_completions / images_api)과 마스크 인페인팅을 중점으로 합니다

핵심 기능

두 개의 노드, 두 개의 경로

Comfyui-Luck gpt-image-2(공식) 및 Comfyui-Luck gpt-2.0 all(리버스) — 상황에 맞는 쪽을 선택하면 됩니다

최대 5장의 참고 이미지

공식 노드는 복잡한 융합과 스타일 전환을 위해 최대 5장의 참고 이미지를 지원합니다

마스크 인페인팅

국소 변경을 위해 편집 영역을 정확히 지정하는 선택적 마스크 입력을 지원합니다

다단계 + 사용자 지정 해상도

1K / 2K / 4K 프리셋과 사용자 지정 크기 지정 지원(최대 변 길이 3840px, 총 픽셀 655,360–8,294,400)

15가지 종횡비

AUTO, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1

품질 및 출력 형식

quality(auto / low / medium / high) + 출력 형식(png / jpeg / webp) + 압축 0-100

이중 엔드포인트(리버스 노드)

gpt-image-2-all는 chat_completions 및 images_api 엔드포인트 간 전환을 지원합니다

내장 타임아웃 및 재시도

타임아웃과 재시도 매개변수가 내장되어 있어 피크 시간대에도 안정적입니다

지원되는 APIYI 모델

모델	모델 ID	노드	용도	API 문서
GPT-Image 2 (공식)	`gpt-image-2`	`Comfyui-Luck gpt-image-2`	네이티브 2K/4K 텍스트-투-이미지, 레퍼런스 이미지 편집, 마스크 인페인팅	보기
GPT-Image 2 All (역방향)	`gpt-image-2-all`	`Comfyui-Luck gpt-2.0 all`	ChatGPT와 동등한 대화형 이미지 생성, 호출당 과금	보기

전체 비교는 gpt-image-2 (공식) vs gpt-image-2-all (역방향) 비교를 참조하십시오.

노드 매개변수

`Comfyui-Luck gpt-image-2` (공식)

매개변수	유형	필수	기본값	설명
`api_key`	string	Yes	-	APIYI token — 사용 한도가 있는 전용 키를 권장합니다
`prompt`	string	Yes	-	생성 또는 편집 지시
`image_1` … `image_5`	IMAGE	No	-	참고 이미지, 최대 5장
`mask`	MASK	No	-	인페인팅용 선택적 마스크(흰색 영역 = 편집 영역)
`size`	enum	No	`2K`	출력 해상도(1K / 2K / 4K / custom)
`custom_size`	string	No	-	`size`가 `custom`일 때 사용하며, 예: `2048x3072`
`aspect_ratio`	enum	No	`AUTO`	15개 종횡비 중 하나
`quality`	enum	No	`auto`	auto / low / medium / high
`output_format`	enum	No	`png`	png / jpeg / webp
`output_compression`	int	No	80	0-100(jpeg / webp에만 적용)

`Comfyui-Luck gpt-2.0 all` (역방향)

매개변수	유형	필수	기본값	설명
`api_key`	string	Yes	-	APIYI token
`prompt`	string	Yes	-	대화형 이미지 prompt
`endpoint`	enum	No	`chat_completions`	`chat_completions` / `images_api`
`response_format`	enum	No	-	`b64_json` / `url` 등
`timeout_seconds`	int	No	-	요청별 타임아웃
`retry_times`	int	No	-	실패 시 재시도 횟수

설치

1단계: custom_nodes에 복제합니다

ComfyUI 설치 폴더 안에서:

cd ComfyUI/custom_nodes
git clone https://github.com/luckdvr/Comfyui-Luck-gpt2.0.git

2단계: 의존성을 설치합니다

cd Comfyui-Luck-gpt2.0
python3 -m pip install -r requirements.txt

3단계: ComfyUI를 다시 시작합니다

노드 팔레트에서 Luck gpt-image-2 또는 Luck gpt-2.0 all를 검색해 찾습니다.

4단계: APIYI 키를 설정합니다

APIYI 콘솔 → Tokens를 방문해 새 키를 생성합니다(안전을 위해 사용 한도를 설정하십시오)
api_key 필드에 붙여넣습니다
노드는 기본적으로 api.apiyi.com를 사용합니다. 필요하면 백업 도메인 vip.apiyi.com / b.apiyi.com로 전환할 수 있습니다

5단계: 예제 워크플로를 가져옵니다

저장소에는 example_workflow.json이 포함되어 있습니다 — 시작점으로 ComfyUI에 가져오십시오.

사용 예시

예제 1: 공식 4K 고품질 텍스트-투-이미지

Node: Comfyui-Luck gpt-image-2
prompt: "Cinematic portrait of a samurai in a misty bamboo forest, volumetric light, 85mm lens, photorealistic"
size: 4K
aspect_ratio: 2:3
quality: high
output_format: png

예제 2: 마스크 인페인팅 (공식)

Node: Comfyui-Luck gpt-image-2
image_1: original photo
mask: the area to be replaced (white = edit region)
prompt: "replace the sky with dramatic sunset clouds, keep everything else intact"
size: 2K
quality: high

예제 3: 역방향 대화형 이미지

Node: Comfyui-Luck gpt-2.0 all
endpoint: chat_completions
prompt: "A girl in hanfu standing under a cherry blossom tree, watercolor style, soft lighting"
response_format: b64_json
timeout_seconds: 180
retry_times: 3

자주 묻는 질문

어떤 노드를 선택해야 합니까?

gpt-image-2 (공식): 제어 가능한 매개변수, 네이티브 마스크 지원, token 단위 과금, 세밀한 해상도/품질 조정 — 특정 크기 요구사항이 있거나 로컬 편집이 필요할 때 가장 적합합니다
gpt-image-2-all (역방향): 호출당 과금 ($0.03/호출), 대화형 자연어 프롬프트, ChatGPT 웹 경험과 동일한 수준 — 반복 편집과 강력한 텍스트 렌더링에 가장 적합합니다
전체 비교: 공식 대 역방향 비교

설치 후 노드를 찾을 수 없습니까?

폴더가 ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0에 있는지 확인합니다
pip install -r requirements.txt가 오류 없이 완료되었는지 확인합니다
ComfyUI를 완전히 다시 시작합니다(프런트엔드만 새로 고치는 것으로는 충분하지 않습니다)

4K 또는 사용자 지정 크기에서 시간 초과가 자주 발생합니까?

역방향 노드에서 timeout_seconds를 높입니다
서버 네트워크가 느리다면 CDN 이미지/동영상 다운로드가 느립니다를 참고하십시오
기본 엔드포인트가 불안정하면 백업 도메인 vip.apiyi.com / b.apiyi.com으로 전환합니다

b64_json에 접두사가 붙어 반환됩니까?

역방향 gpt-image-2-all은 b64_json를 data:image/png;base64, 접두사와 함께 반환하지만, 공식 gpt-image-2은 그렇지 않습니다. 자세한 내용은 공식 대 역방향 비교를 참고하십시오.

호출이 401 / 403을 반환합니까?

api_key의 유효성과 채널 제한 여부를 확인합니다
선택한 모델이 token에 화이트리스트로 등록되어 있는지 확인합니다
잔액 문제입니다 — 잔액은 충분해 보이는데 호출이 실패합니다를 참고하십시오

gpt-image-2 (공식) 문서

네이티브 2K/4K 생성, token당 과금

gpt-image-2-all (리버스) 문서

ChatGPT와 동일한 수준, 호출당 $0.03

공식 버전 vs 리버스 비교

17개 항목의 나란히 비교 표

ComfyUI 노드 모음

더 많은 APIYI 맞춤형 ComfyUI 노드를 둘러보세요

Luck Nano Banana Pro (같은 작성자)

luckdvr의 Gemini 계열 ComfyUI 노드

APIYI GPT-Image 2 스킬 (동일한 모델)

같은 두 GPT 이미지 모델을 위한 AI Agent Skill 형식

APIYI 콘솔

키, 사용량, 채널을 관리합니다

개요

대화형 AI

프로그래밍

커뮤니티 기여

AI 에이전트

엔지니어링

번역

Luck GPT-Image 2 - ComfyUI 노드

개요

핵심 기능

두 개의 노드, 두 개의 경로

최대 5장의 참고 이미지

마스크 인페인팅

다단계 + 사용자 지정 해상도

15가지 종횡비

품질 및 출력 형식

이중 엔드포인트(리버스 노드)

내장 타임아웃 및 재시도

지원되는 APIYI 모델

노드 매개변수

`Comfyui-Luck gpt-image-2` (공식)

`Comfyui-Luck gpt-2.0 all` (역방향)

설치

사용 예시

예제 1: 공식 4K 고품질 텍스트-투-이미지

예제 2: 마스크 인페인팅 (공식)

예제 3: 역방향 대화형 이미지

자주 묻는 질문

관련 자료

gpt-image-2 (공식) 문서

gpt-image-2-all (리버스) 문서

공식 버전 vs 리버스 비교

ComfyUI 노드 모음

Luck Nano Banana Pro (같은 작성자)

APIYI GPT-Image 2 스킬 (동일한 모델)

APIYI 콘솔

​개요

​핵심 기능

두 개의 노드, 두 개의 경로

최대 5장의 참고 이미지

마스크 인페인팅

다단계 + 사용자 지정 해상도

15가지 종횡비

품질 및 출력 형식

이중 엔드포인트(리버스 노드)

내장 타임아웃 및 재시도

​지원되는 APIYI 모델

​노드 매개변수

​Comfyui-Luck gpt-image-2 (공식)

​Comfyui-Luck gpt-2.0 all (역방향)

​설치

​사용 예시

​예제 1: 공식 4K 고품질 텍스트-투-이미지

​예제 2: 마스크 인페인팅 (공식)

​예제 3: 역방향 대화형 이미지

​자주 묻는 질문

​관련 자료

gpt-image-2 (공식) 문서

gpt-image-2-all (리버스) 문서

공식 버전 vs 리버스 비교

ComfyUI 노드 모음

Luck Nano Banana Pro (같은 작성자)

APIYI GPT-Image 2 스킬 (동일한 모델)

APIYI 콘솔

개요

핵심 기능

지원되는 APIYI 모델

노드 매개변수

`Comfyui-Luck gpt-image-2` (공식)

`Comfyui-Luck gpt-2.0 all` (역방향)

설치

사용 예시

예제 1: 공식 4K 고품질 텍스트-투-이미지

예제 2: 마스크 인페인팅 (공식)

예제 3: 역방향 대화형 이미지

자주 묻는 질문

관련 자료