概述
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 文生图提示词控制器(文生图提示词控制器)/图生图提示词控制器(图生图提示词控制器)/文本停留编辑器(文本暂停编辑器)。这些节点使用多模态模型将需求转换为结构化图像提示词,并可暂停工作流以便手动编辑
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 中报告
핵심 기능
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 입력으로 편집 영역을 정확하게 지정할 수 있습니다(투명 영역은 다시 칠하고 불투명 영역은 유지합니다)실제 해상도 + 사용자 지정 크기
프롬프트 컨트롤러
gemini-3.5-flash은 텍스트 개요 또는 최대 5개의 참조 이미지를 구조화된 이미지 prompt로 변환하며, 수동 편집을 위해 선택적으로 일시 중지할 수 있습니다내장된 타임아웃 및 재시도
408 / 429 / 5xx은 retry_times에 따라 재시도하므로 피크 시간대의 변동에도 대응합니다지원되는 APIYI 모델
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에서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단계: custom_nodes로 클론
git pull을 실행하여 2.5 지원을 적용할 수 있습니다.2단계: 의존성 패키지 설치
3단계: ComfyUI 완전 재시작
Comfyui-Luck을(를) 검색하여 3개의 이미지 노드와 3개의 prompt 노드를 찾을 수 있습니다. 프런트엔드를 새로고침하는 것만으로는 충분하지 않으므로 플러그인을 업데이트한 후 프로세스를 재시작해야 합니다.4단계: APIYI 키 및 도메인 설정
- APIYI 콘솔 → Tokens로 이동하여 키를 생성합니다(사용량 한도 설정을 권장합니다).
- 생성한 키를 노드의
api_key필드에 붙여넣습니다. api_base중 하나를 선택합니다:https://api.apiyi.com/v1(기본) /https://b.apiyi.com/v1(중국 본토 백업). 노드는/v1포함 여부와 관계없이 base URL을 허용합니다.
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이 기본값으로 설정되어 있습니다.
사용 예시
예시 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 리버스
플러그인을 업데이트한 후 기존 워크플로우가 2.5로 전환됩니까?
플러그인을 업데이트한 후 기존 워크플로우가 2.5로 전환됩니까?
gpt-image-2이 변경되지 않으므로, 기존 워크플로우는 원래 품질로 gpt-image-2을 계속 실행합니다. 2.5를 사용하려면 model (模型) 드롭다운을 수동으로 전환하고 위 표를 참조하여 quality을 다시 선택하십시오.동일한 high 설정에서 2.5로 전환한 후 더 저렴해지고 더 흐릿해진 이유는 무엇입니까?
동일한 high 설정에서 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.5-all / gpt-image-2.5-vip을 지원합니까?
플러그인이 gpt-image-2.5-all / gpt-image-2.5-vip을 지원합니까?
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를 직접 호출하십시오.설치 후 노드를 찾을 수 없습니까?
설치 후 노드를 찾을 수 없습니까?
- 폴더가
ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0에 위치해 있는지 확인하십시오 pip install -r requirements.txt이 오류 없이 완료되었는지 확인하십시오- ComfyUI를 완전히 다시 시작하십시오 (프론트엔드 새로고침만으로는 부족합니다)
4K, xhigh / max 또는 사용자 지정 크기에서 시간 초과가 자주 발생합니까?
4K, xhigh / max 또는 사용자 지정 크기에서 시간 초과가 자주 발생합니까?
- 공식 노드의 기본 읽기 타임아웃은 600초입니다. 2.5
xhigh/max및 2K / 4K의 경우 이 값을 유지하거나 늘리십시오.408 Timeout은 대개 노드 매개변수 오류가 아니라 제공업체 측의 생성 작업 시간이 초과되었음을 의미합니다 - 클라이언트 측 시간 초과가 발생한 후에도 동기식 요청에 대해 과금이 발생할 수 있으며, 자동 재시도로 인해 비용이 추가될 수 있습니다. 재시도를 비활성화하려면
retry_times을1으로 설정하십시오 - 서버 네트워크가 느린 경우 CDN 이미지/동영상 다운로드 속도가 느림을 참조하십시오
- 기본 도메인이 불안정한 경우
api_base을b.apiyi.com/v1으로 전환하십시오
이전 워크플로우를 불러올 때 Value 3 smaller than min of 30 오류가 발생합니까?
이전 워크플로우를 불러올 때 Value 3 smaller than min of 30 오류가 발생합니까?
retry_times=3이 timeout_seconds=3로 잘못 읽혔습니다. 저장소의 최신 example_workflow.json을 사용하거나 노드를 삭제한 후 다시 추가하십시오.일시 중지 에디터를 연결한 후 gpt-image-2에서 Value not in list 오류가 보고됩니까?
일시 중지 에디터를 연결한 후 gpt-image-2에서 Value not in list 오류가 보고됩니까?
prompt을 입력 소켓으로 변환하면 이전 워크플로우에서 prompt 자리 표시자가 하나 부족해져 그 뒤의 위젯들이 하나씩 밀리게 됩니다(예: mode가 gpt-image-2을 읽고, api_base가 2K를 읽음). 최신 노드는 유효성 검사를 통과하고 런타임에 밀린 값을 복원합니다. 패널에 여전히 밀린 상태로 표시된다면 현재 워크플로우를 다시 불러오거나 Comfyui-Luck gpt-image-2을 다시 추가하십시오.리버스 노드의 b64_json 반환값에 접두사가 포함되어 있습니까?
리버스 노드의 b64_json 반환값에 접두사가 포함되어 있습니까?
gpt-image-2-all / gpt-image-2-vip은 data:image/png;base64, 접두사가 포함된 b64_json을 반환하는 반면, 공식 gpt-image-2 라인은 그렇지 않습니다. 세 노드 모두 두 형식을 자동으로 디코딩하므로 출력을 PreviewImage에 직접 연결하십시오. 자세한 내용은 공식 vs 리버스 비교를 참조하십시오.호출 시 401 / 403이 반환됩니까?
호출 시 401 / 403이 반환됩니까?
api_key의 유효성 및 그룹별로 제한되어 있는지 확인하십시오- 선택한 모델이 token 화이트리스트에 포함되어 있는지 확인하십시오
- 잔액 문제: 잔액은 충분해 보이지만 호출에 실패함을 참조하십시오