메인 콘텐츠로 건너뛰기

概述

Comfyui-Luck-gpt2.0 是由社区用户 luckdvr 贡献的 ComfyUI 自定义节点包,可在 ComfyUI 中直接调用 APIYI 的 GPT 图像模型。该节点包目前包含 三个图像节点和三个提示词控制节点:
  • Comfyui-Luck gpt-image-2(官方):模型下拉菜单提供 gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst,发送真实的 size / quality,支持蒙版局部重绘和最多 16 张参考图像
  • Comfyui-Luck gpt-2.0 all(逆向):调用 gpt-image-2-all,按调用次数计费,速度快,支持对话式编辑
  • Comfyui-Luck gpt-image-2-vip(逆向):调用 gpt-image-2-vip,按调用次数计费,使用 Adobe 路由
  • 提示词控制节点:GPT-Image-2 文生图提示词控制器(文生图提示词控制器)/ 图生图提示词控制器(图生图提示词控制器)/ 文本停留编辑器(文本暂停编辑器)。这些节点使用多模态模型将需求转换为结构化图像提示词,并可暂停工作流以便手动编辑
2026-09-10 更新:支持 GPT-Image 2.5。 官方节点新增 gpt-image-2.5-flare(速度优先)和 gpt-image-2.5-sunburst(质量与编辑精度优先),quality 扩展至六个等级(新增 xhigh / max)。节点名称、ID、控件顺序和默认模型 gpt-image-2 均保持不变,因此现有工作流不会自动切换模型或画质。更新插件后,请在 model (模型) 下拉菜单中选择模型。请参阅下文“在节点中使用 GPT-Image 2.5”。
项目信息
  • 🔗 源代码:github.com/luckdvr/Comfyui-Luck-gpt2.0
  • 📜 许可证:Apache-2.0
  • 👤 作者:luckdvr
  • ⭐ 为 APIYI 构建的社区贡献项目。如遇 API 行为变更或节点错误,请优先在代码库的 Issues 中报告
如何区分该节点包与作者的另一个节点包?luckdvr 为 APIYI 贡献了两个 ComfyUI 节点包:
  • Luck Nano Banana Pro:调用 Gemini 系列(gemini-3-pro-image / gemini-3.1-flash-image),侧重于支持 14 张参考图像,以及工程级的重试和超时处理
  • Luck GPT-Image 2(本页面):调用 OpenAI 系列(gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2-all / gpt-image-2-vip),侧重于真实的 size / quality 控制、蒙版局部重绘和提示词控制器

핵심 기능

3개 노드, 3개 경로

공식 gpt-image-2, 리버스 gpt-2.0 all, 리버스 gpt-image-2-vip가 각각 하나의 경로를 담당합니다. 예산과 필요에 따라 선택합니다

GPT-Image 2.5 트윈 모델

공식 노드를 gpt-image-2.5-flare / gpt-image-2.5-sunburst으로 전환할 수 있으며, 버전 고정을 위해 날짜별 -2026-09-08 스냅샷도 제공됩니다

6개 품질 등급

quality은 auto / low / medium / high / xhigh / max를 지원하며, xhigh / max는 2.5 모델 2종에서만 지원됩니다

최대 16개의 참조 이미지

공식 노드는 image_01 … image_16을 받으며, 두 리버스 노드는 최대 14개까지 받아 다중 이미지 융합 및 스타일 전송을 지원합니다

마스크 인페인팅

공식 노드의 선택적 mask 입력으로 편집 영역을 정확하게 지정할 수 있습니다(투명 영역은 다시 칠하고 불투명 영역은 유지합니다)

실제 해상도 + 사용자 지정 크기

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

프롬프트 컨트롤러

기본 gemini-3.5-flash은 텍스트 개요 또는 최대 5개의 참조 이미지를 구조화된 이미지 prompt로 변환하며, 수동 편집을 위해 선택적으로 일시 중지할 수 있습니다

내장된 타임아웃 및 재시도

공식 노드의 기본 타임아웃은 600초이며, 408 / 429 / 5xx은 retry_times에 따라 재시도하므로 피크 시간대의 변동에도 대응합니다

지원되는 APIYI 모델

3가지 공식 모델은 동일한 가격과 파라미터를 공유하며 token당 과금됩니다. 리버스 모델은 호출당 과금됩니다: gpt-image-2-all 이미지당 $0.025, gpt-image-2-vip 이미지당 $0.03. 공식 모델과 리버스 모델의 전체 비교 내용은 gpt-image-2.5 / 2 공식 vs 리버스 비교를 확인하십시오.

노드에서 GPT-Image 2.5 사용하기

플러그인을 업데이트하고 ComfyUI를 완전히 다시 시작한 다음, Comfyui-Luck gpt-image-2에서 model (模型) 드롭다운을 전환합니다. 다른 모든 위젯은 그대로 유지됩니다. 두 2.5 모델 모두 텍스트-이미지 변환, 이미지 편집, 참조 이미지 16개 및 마스크를 지원합니다. 노드는 mode와 참조 이미지 연결 여부에 따라 생성 또는 편집 엔드포인트를 선택합니다.
gpt-image-2에서 2.5로 이동할 때 quality을 변경 없이 그대로 적용하지 마십시오. 2026-09-09 APIYI의 동일 크기 출력 token 측정에 따르면 2.5의 high은 이전 medium에 대응하고, 2.5의 max만 이전 high에 대응합니다. 이는 token 예산의 대응 관계일 뿐, 픽셀 단위의 품질이 동일하다는 보장은 아닙니다. 2.5에서 이전 high 예산에 맞추려면 max를 선택합니다. 동일한 예산에서 2.5의 high / xhigh는 더 저렴한 중간 단계 두 가지를 제공합니다.
워크플로를 구축하기 전에 알아 두어야 할 노드 수준의 동작은 다음과 같습니다.
  • 자동 하향 조정 없음: 이전 gpt-image-2에서 xhigh / max을 선택하거나 유효하지 않은 모델 / 품질을 선택하면, 노드는 전송 전에 오류를 발생시킵니다. 노드가 해당 단계를 임의로 바꾸는 일은 없습니다
  • auto은 신중하게 사용: auto은 동적 추론 단계이므로 동일한 prompt에 대한 비용과 지연 시간이 단계마다 달라질 수 있습니다. 지출을 제어하려면 단계를 명시적으로 선택합니다
  • 프로덕션에서는 날짜가 지정된 스냅샷 고정: 드롭다운의 gpt-image-2.5-flare-2026-09-08 / gpt-image-2.5-sunburst-2026-09-08은 모델 버전을 고정하므로, 업스트림의 별칭이 변경되어도 모델이 바뀌지 않습니다
  • 600초 타임아웃 유지: 2.5 xhigh / max, 2K / 4K 또는 복잡한 편집의 경우 기본값을 유지하거나 늘립니다. 클라이언트의 타임아웃 이후에도 동기 요청에 대한 과금이 계속될 수 있으며, 자동 재시도로 비용이 추가될 수 있습니다. 재시도를 원하지 않으면 retry_times을 1로 설정합니다

노드 매개변수

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

패널의 위젯 라벨에는 api_key (API密钥)와 같이 중국어 접미사가 붙어 있으며, 아래 표에는 영문 필드 이름만 기재되어 있습니다. custom_size에 대한 네 가지 제약 조건: 모든 변은 3840px 이하, 너비와 높이는 모두 16의 배수, 긴 변 / 짧은 변 비율은 최대 3:1, 총 픽셀 수는 655,360에서 8,294,400 사이여야 합니다. 1:4 / 4:1 / 1:8 / 8:1 비율은 공식 3:1 제한을 초과하므로 노드에서 가장 가까운 유효한 경계 크기로 맞춥니다. 4K + 1:1은(는) 후자가 총 픽셀 수 한도를 초과하기 때문에 3840x3840 대신 2880x2880을(를) 사용합니다.
이 노드는 background / moderation / response_format / input_fidelity을(를) 전송하지 않으며, 모두 API 기본값으로 대체됩니다. 투명 배경 및 유사한 옵션을 사용하려면 API를 직접 호출하십시오(투명 배경에는 gpt-image-2.5-flare / gpt-image-2.5-sunburst이(가) 필요하며, OpenAI는 2026-09-30에 gpt-image-2에 대한 지원을 중단했습니다). 자세한 내용은 투명 배경 FAQ를 참조하십시오.

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

gpt-image-2-all는 size / quality / n / aspect_ratio API 필드를 허용하지 않으며 노드는 이를 전송하지 않습니다. 2K / 4K는 픽셀을 보장하지 않고 prompt에만 설명할 수 있습니다. url 출력은 일반적으로 약 하루 동안 유효한 임시 CDN 링크이므로, 장기간 사용해야 한다면 다시 호스팅해야 합니다.

Comfyui-Luck gpt-image-2-vip (반전)

gpt-2.0 all와 동일한 위젯에 크기 제어 항목 두 개가 추가됩니다.
작성자는 size이 비활성화되었다는 APIYI의 2026-06-23 공지를 기준으로 이 노드를 구축했으므로, 기본적으로 size을 전송하지 않습니다. APIYI 측에서는 gpt-image-2-vip에 대한 size을 2026-07-22에 복원했습니다(일반적인 크기 30개, gpt-image-2-vip 문서 참조). 그러나 플러그인은 아직 이를 반영하지 않았습니다. 현재 ComfyUI에서 실제 출력 크기를 고정하려면 공식 노드 Comfyui-Luck gpt-image-2을 사용하십시오. 반전 b64_json에는 data:image/png;base64, 접두사가 포함되며, 노드가 이를 자동으로 디코딩합니다.

프롬프트 제어 노드

  • 두 컨트롤러 모두 APIYI POST /v1/chat/completions을 호출하며, 모델 드롭다운에는 gemini-3.5-flash / gpt-5.5 / gpt-4o / gpt-4.1-mini / gemini-2.5-flash / gemini-2.5-pro이 표시됩니다
  • 이미지 간 변환 컨트롤러는 이미지를 이해하고 prompt를 개선하는 작업만 수행합니다. 실제 다중 이미지 참조 또는 융합을 사용하려면 동일한 이미지를 다운스트림 이미지 노드에도 연결합니다
  • 일시 중지 편집기의 edited_text은 이미지 노드의 prompt에 전달되는 단일 문자열이며, edited_texts은 배치 텍스트 워크플로를 위해 예약된 목록 출력입니다. 일시 중지 후에는 노드에서 Continue을 클릭합니다. 기본 Run 버튼을 다시 누르지 마십시오. 그러면 ComfyUI가 업스트림 prompt 개선 작업을 다시 큐에 추가하고 재실행합니다

설치

1

1단계: custom_nodes로 클론

ComfyUI 설치 경로 내부에서 실행합니다:
기존 사용자는 해당 폴더에서 git pull을 실행하여 2.5 지원을 적용할 수 있습니다.
2

2단계: 의존성 패키지 설치

3

3단계: ComfyUI 완전 재시작

노드 팔레트에서 Comfyui-Luck을(를) 검색하여 3개의 이미지 노드와 3개의 prompt 노드를 찾을 수 있습니다. 프런트엔드를 새로고침하는 것만으로는 충분하지 않으므로 플러그인을 업데이트한 후 프로세스를 재시작해야 합니다.
4

4단계: APIYI 키 및 도메인 설정

  • APIYI 콘솔 → Tokens로 이동하여 키를 생성합니다(사용량 한도 설정을 권장합니다).
  • 생성한 키를 노드의 api_key 필드에 붙여넣습니다.
  • api_base 중 하나를 선택합니다: https://api.apiyi.com/v1 (기본) / https://b.apiyi.com/v1 (중국 본토 백업). 노드는 /v1 포함 여부와 관계없이 base URL을 허용합니다.
5

5단계: 예제 워크플로우 가져오기

저장소에서 두 가지 예제를 제공합니다:
  • example_workflow.json: 이미지 노드당 예제 1개 제공(공식 예제는 size=2048x1152 + quality=high + jpeg 사용), 선택 방법을 설명하는 중국어 Note 노드 포함
  • example_workflow_gpt_image_2_5.json: Flare text-to-image → Sunburst 편집 → 미리보기로 구성된 독립형 2.5 예제이며, 1K + 1:1, quality=high, 600초 타임아웃 및 retry_times=1이 기본값으로 설정되어 있습니다.
예제에 포함된 API 키는 비어 있으므로 실행하려면 본인의 키를 입력해야 합니다. 직접 만든 워크플로우를 공유하기 전에는 키를 삭제하십시오.

사용 예시

예시 1: 2.5 Flare 4K 고품질 텍스트-이미지

max은 이전 gpt-image-2 high와 동일한 token 예산을 사용하는 2.5 등급입니다. 더 빠르고 저렴한 결과를 원한다면 먼저 high 또는 xhigh을 사용해 보시기 바랍니다.

예시 2: 2.5 Sunburst 마스크 인페인팅

예시 3: Flare 텍스트-이미지 → Sunburst 편집 체인

저장소의 example_workflow_gpt_image_2_5.json과 일치합니다.

예시 4: 대화형 이미지 역변환

예시 5: 프롬프트 컨트롤러 → 일시 중지 및 편집 → 생성

최종 PreviewImage / SaveImage에서 실행을 대기열에 추가합니다. 플로우가 일시 중지 편집기에서 멈추면 텍스트를 편집하고 노드에서 Continue을 클릭합니다. 이미지 하나를 고정해야 하는 주제 이미지로 사용하려는 경우에는 해당 이미지를 컨트롤러의 subject_image에도 연결하고 이미지 노드의 image_01에 배치합니다.

자주 묻는 질문

  • Comfyui-Luck gpt-image-2 (공식): 실제 size / quality, 네이티브 마스크, 최대 16개 참조, token당 과금. 정확한 크기, 로컬 편집 또는 6가지 2.5 품질 티어가 필요한 경우 선택하십시오. 텍스트 투 이미지에는 gpt-image-2.5-flare, 편집에는 gpt-image-2.5-sunburst을 기본값으로 권장합니다
  • Comfyui-Luck gpt-2.0 all (리버스): 호출당 과금 (이미지당 $0.025), 약 30–60초 소요, ChatGPT 웹 경로. 엄격한 크기 제어가 필요하지 않고 반복적인 편집과 강력한 텍스트 렌더링이 필요한 경우 선택하십시오
  • Comfyui-Luck gpt-image-2-vip (리버스): 호출당 과금 (이미지당 $0.03), 약 90–150초 소요, Adobe 경로. 예비용으로 활용할 수 있는 두 번째 리버스 경로이며, 현재 플러그인은 size을 전송하지 않습니다
  • 전체 비교: 공식 vs 리버스
아닙니다. 노드 이름, ID, 위젯 순서 및 기본 모델 gpt-image-2이 변경되지 않으므로, 기존 워크플로우는 원래 품질로 gpt-image-2을 계속 실행합니다. 2.5를 사용하려면 model (模型) 드롭다운을 수동으로 전환하고 위 표를 참조하여 quality을 다시 선택하십시오.
2.5에서는 품질 티어가 재조정되었습니다. APIYI의 2026-09-09 동일 크기 측정 결과에 따르면, 2.5 high은 gpt-image-2 high의 약 4분의 1 수준의 token을 출력하여 기존 medium과 일치합니다. 2.5에서 기존 high 예산을 확보하려면 max를 선택하십시오. 반대로 동일한 예산에서 2.5는 두 가지 더 저렴한 중간 티어로 high / xhigh을 추가했습니다. 프로덕션 환경에 적용하기 전에 티어별로 prompt를 직접 한 번씩 실행하고 usage.output_tokens을 비교해 보십시오.
두 리버스 노드에는 현재 gpt-image-2-all 및 gpt-image-2-vip만 나열되어 있습니다. gpt-image-2-all의 기반이 되는 ChatGPT 웹 앱이 Images 2.5로 업그레이드되었으므로, 해당 모델은 이미 2.5 이미지를 생성하며 동작 방식과 비용은 gpt-image-2.5-all과 동일합니다. 자세한 내용은 gpt-image-2.5-all 문서를 참조하십시오. gpt-image-2.5-flare-vip / gpt-image-2.5-sunburst-vip은 아직 노드 드롭다운에 포함되지 않았으므로, 필요한 경우 API를 직접 호출하십시오.
  1. 폴더가 ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0에 위치해 있는지 확인하십시오
  2. pip install -r requirements.txt이 오류 없이 완료되었는지 확인하십시오
  3. ComfyUI를 완전히 다시 시작하십시오 (프론트엔드 새로고침만으로는 부족합니다)
  • 공식 노드의 기본 읽기 타임아웃은 600초입니다. 2.5 xhigh / max 및 2K / 4K의 경우 이 값을 유지하거나 늘리십시오. 408 Timeout은 대개 노드 매개변수 오류가 아니라 제공업체 측의 생성 작업 시간이 초과되었음을 의미합니다
  • 클라이언트 측 시간 초과가 발생한 후에도 동기식 요청에 대해 과금이 발생할 수 있으며, 자동 재시도로 인해 비용이 추가될 수 있습니다. 재시도를 비활성화하려면 retry_times을 1으로 설정하십시오
  • 서버 네트워크가 느린 경우 CDN 이미지/동영상 다운로드 속도가 느림을 참조하십시오
  • 기본 도메인이 불안정한 경우 api_base을 b.apiyi.com/v1으로 전환하십시오
이전 워크플로우의 위젯 순서가 노드와 더 이상 일치하지 않아 retry_times=3이 timeout_seconds=3로 잘못 읽혔습니다. 저장소의 최신 example_workflow.json을 사용하거나 노드를 삭제한 후 다시 추가하십시오.
prompt을 입력 소켓으로 변환하면 이전 워크플로우에서 prompt 자리 표시자가 하나 부족해져 그 뒤의 위젯들이 하나씩 밀리게 됩니다(예: mode가 gpt-image-2을 읽고, api_base가 2K를 읽음). 최신 노드는 유효성 검사를 통과하고 런타임에 밀린 값을 복원합니다. 패널에 여전히 밀린 상태로 표시된다면 현재 워크플로우를 다시 불러오거나 Comfyui-Luck gpt-image-2을 다시 추가하십시오.
리버스 gpt-image-2-all / gpt-image-2-vip은 data:image/png;base64, 접두사가 포함된 b64_json을 반환하는 반면, 공식 gpt-image-2 라인은 그렇지 않습니다. 세 노드 모두 두 형식을 자동으로 디코딩하므로 출력을 PreviewImage에 직접 연결하십시오. 자세한 내용은 공식 vs 리버스 비교를 참조하십시오.
  1. api_key의 유효성 및 그룹별로 제한되어 있는지 확인하십시오
  2. 선택한 모델이 token 화이트리스트에 포함되어 있는지 확인하십시오
  3. 잔액 문제: 잔액은 충분해 보이지만 호출에 실패함을 참조하십시오

관련 리소스

gpt-image-2.5 / 2 (공식) 문서

flare / sunburst / gpt-image-2 가격 및 파라미터 공유, 네이티브 2K/4K, token당 과금

GPT-image-2.5 출시 설명서

Flare는 더 빠르고 Sunburst는 더 정밀합니다. 6가지 품질 등급 및 마이그레이션 가이드

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

ChatGPT 웹 경로, 이미지당 $0.025

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

Adobe 경로, 이미지당 $0.03, 30개 크기 지원

공식 vs 리버스 비교

공식과 리버스의 차이점을 한눈에 정리한 비교표

ComfyUI 노드 컬렉션

APIYI에 맞춤화된 더 많은 ComfyUI 노드 둘러보기

Luck Nano Banana Pro (동일 제작자)

luckdvr의 Gemini 라인 ComfyUI 노드

APIYI GPT-Image 2 Skills (동일 모델)

GPT 이미지 모델 기반 AI Agent Skill 버전

APIYI 콘솔

키, 사용량 및 그룹 관리