# TJ NODE STUDIO ONE (통합 패키지) # TJ NODE STUDIO ONE (Integrated Package) > **ComfyUI 올인원 이미지 생성 UI 패키지** — Z-Image ONE STUDIO, Flux.2 Klein ONE STUDIO, Qwen Image Edit 2511 ONE STUDIO, Krea 2 ONE STUDIO, **SDXL ONE STUDIO**, Minimax H3 ONE STUDIO, **Anima ONE STUDIO** 일곱 가지 노드를 단일 패키지로 제공합니다. > **ComfyUI all-in-one image generation UI package** — Z-Image ONE STUDIO, Flux.2 Klein ONE STUDIO, Qwen Image Edit 2511 ONE STUDIO, Krea 2 ONE STUDIO, **SDXL ONE STUDIO**, Minimax H3 ONE STUDIO, **Anima ONE STUDIO** — seven nodes in a single package. > > 워크플로우 배선 없이 노드 하나에서 T2I · I2I · Inpaint · Outpaint · ControlNet · Edit · Faceswap · ANGLE · Upscale(SeedVR2) 등 다양한 모드를 전환합니다. > switch between modes in a single node without workflow wiring T2I · I2I · Inpaint · Outpaint · ControlNet · Edit · Faceswap · ANGLE · Upscale(SeedVR2) etc. switch between various modes. > > 🆕 **Anima ONE STUDIO가 새롭게 추가되었습니다.** ComfyUI 네이티브 애니메이션풍 이미지 모델 Anima를 위한 노드로, T2I · Inpainting · Any Control to Image · Depth Control to Image 4가지 모드와 Turbo LoRA 토글, 브러시로 직접 칠하는 인라인 마스크 에디터(반전 포함)를 제공합니다. > > 🆕 **Anima ONE STUDIO has been added.** A node for ComfyUI's native anime-style image model Anima, with T2I · Inpainting · Any Control to Image · Depth Control to Image modes, a Turbo LoRA toggle, and an inline brush-paint mask editor (with invert). > > 미니맥스 H3 노드가 새롭게 추가 되었습니다. FL2VA / REF2VA / Turbo Lora / Cache와 멀티 프롬포트로 동시에 여러개의 클립을 생성하거나 이전 클립의 라스트 프레임을 다음 클립의 퍼스트 프레임으로 받아서 연속적인 영상을 만들수 있습니다. 여러개 클립의 생성시 최종 클립이 완료되면 모든 영상을 스티치하여 하나의 영상으로 생성도 가능합니다. > > The MiniMax H3 node has been added. Using FL2VA, REF2VA, Turbo Lora, and Cache, along with multi-port functionality, you can create multiple clips simultaneously or use the last frame of the previous clip as the first frame of the next clip to generate a continuous video. When creating multiple clips, once the final clip is complete, you can stitch all the clips together to create a single video. > > 🧪 **SDXL ONE STUDIO는 현재 테스트 버전입니다.** 기능은 동작하지만 일부 옵션이 변경될 수 있습니다. > 🧪 **SDXL ONE STUDIO is currently a test/beta version.** Core features are functional but some options may change. > > ⚠️ **생성 방식**: 모든 노드의 생성은 ComfyUI 상단 **RUN**이 아닌 노드 내부의 **▶ Generate** 버튼으로 실행합니다. RUN 실행 시 마지막으로 생성된 이미지가 OUTPUT image 슬롯으로 출력됩니다. > ⚠️ **Generation Method**: generation for all nodes is executed using at the top of ComfyUI **RUN**instead of, use the button inside the node **▶ Generate** button. When RUN is executed, the most recently generated image is output through the OUTPUT image slot..

Screen Shot 2026-06-27 at 05 58 39 907 AM

--- ## ⚠️ 설치 후 필수 단계 — 의존성 노드 설치 ## ⚠️ Required step after install — install the dependency nodes > **ComfyUI-Manager로 이 패키지를 설치하면 Python 패키지는 자동으로 설치되지만, 이 노드가 의존하는 다른 커스텀 노드 팩은 자동으로 설치되지 않습니다.** (Manager의 nightly/git 설치 경로에는 노드 팩을 자동 설치하는 기능이 없습니다.) 설치 직후 아래 스크립트를 **한 번** 실행한 뒤 ComfyUI를 재시작하세요. 실행하지 않으면 노드는 뜨지만 Face Redraw · Faceswap · ControlNet · RE-BG · Upscale · MiniMax H3 Reference 등 여러 모드가 로드에 실패합니다. 어떤 팩이 빠졌는지는 ComfyUI 시작 시 콘솔에 배너로 표시됩니다. > > **Windows:** 패키지 폴더의 `install_requirements.bat` 더블클릭 > **Mac / Linux:** `bash install_requirements.sh` > > 자세한 목록은 [필수 커스텀 노드](#필수-커스텀-노드) 섹션 참고. > > --- > > **When you install this package via ComfyUI-Manager, the Python packages install automatically but the other custom-node packs this node depends on do NOT** (Manager's nightly/git install path has no mechanism for auto-installing node packs). Run the script below **once** right after install, then restart ComfyUI. Without it the node loads but several modes fail — Face Redraw, Faceswap, ControlNet, RE-BG, Upscale, MiniMax H3 Reference. The ComfyUI console prints a banner at startup listing exactly which packs are missing. > > **Windows:** double-click `install_requirements.bat` in the package folder > **Mac / Linux:** `bash install_requirements.sh` > > See [Required Custom Nodes](#필수-커스텀-노드) for the full list. --- ## 🌐 웹 버전 — AI ONE STUDIO ## 🌐 Web Version — AI ONE STUDIO **[designloves2/AI-ONE-STUDIO](https://github.com/designloves2/AI-ONE-STUDIO)** — 이 커스텀 노드 패키지의 UI를 그대로 재현한 독립 웹 애플리케이션입니다. ComfyUI를 백엔드로 그대로 사용하며(Manager/노드 설치 불필요, ComfyUI 서버만 켜져 있으면 됨), 브라우저에서 ComfyUI 캔버스 없이 풀스크린 메뉴형 UI로 각 ONE STUDIO 툴을 바로 사용할 수 있습니다. **[designloves2/AI-ONE-STUDIO](https://github.com/designloves2/AI-ONE-STUDIO)** — a standalone web app that reproduces this custom-node package's UI as-is. It runs against a plain ComfyUI server as its backend (no Manager or node install needed on the client side — just keep ComfyUI running), and lets you use every ONE STUDIO tool in a fullscreen, menu-driven UI in the browser, without the ComfyUI graph canvas.

--- ## 목차 ## Table of Contents 1. [포함 노드](#포함-노드) 1. [Included Nodes](#포함-노드) 2. [설치 방법](#설치-방법) 2. [Installation](#설치-방법) 3. [필수 커스텀 노드](#필수-커스텀-노드) 3. [Required Custom Nodes](#필수-커스텀-노드) 4. [Z-Image ONE STUDIO — 기능 상세](#z-image-one-studio--기능-상세) 4. [Z-Image ONE STUDIO — Feature Details](#z-image-one-studio--기능-상세) 5. [Flux.2 Klein ONE STUDIO — 기능 상세](#flux2-klein-one-studio--기능-상세) 5. [Flux.2 Klein ONE STUDIO — Feature Details](#flux2-klein-one-studio--기능-상세) 6. [Qwen Image Edit 2511 ONE STUDIO — 기능 상세](#qwen-image-edit-2511-one-studio--기능-상세) 6. [Qwen Image Edit 2511 ONE STUDIO — Feature Details](#qwen-image-edit-2511-one-studio--기능-상세) 7. [Krea 2 ONE STUDIO — 기능 상세](#krea-2-one-studio--기능-상세) 7. [Krea 2 ONE STUDIO — Feature Details](#krea-2-one-studio--기능-상세) 8. [SDXL ONE STUDIO — 기능 상세 🧪](#sdxl-one-studio--기능-상세-) 8. [SDXL ONE STUDIO — Feature Details 🧪](#sdxl-one-studio--기능-상세-) 9. [공통 기능](#공통-기능) 9. [Common Features](#공통-기능) 10. [MiniMax H3 ONE STUDIO — 기능 상세 🧪](#minimax-h3-one-studio--기능-상세-) 10. [MiniMax H3 ONE STUDIO — Feature Details 🧪](#minimax-h3-one-studio--기능-상세-) 11. [버그 수정 이력](#버그-수정-이력) 11. [Bug Fix History](#버그-수정-이력) 12. [라이선스](#라이선스) 12. [License](#라이선스) --- ## 포함 노드 ## Included Nodes | 노드 이름
_{Node Name}| 대상 모델
_{Target Model}| 지원 모드
_{Supported Modes}| |---|---|---| | **Z-Image ONE STUDIO (TJ)** | Z-Image Turbo (flow-matching) | T2I · I2I · Inpaint · Outpaint · RE-BG · ControlNet · Face Redraw · **Upscale** | | **Flux.2 Klein ONE STUDIO (TJ)** | Flux.2-Klein (9B / 4B) | T2I · I2I · Edit · **Inpaint · Outpaint** · Faceswap · **Upscale** | | **Qwen Image Edit 2511 ONE STUDIO (TJ)** | Qwen2.5-VL 기반 Image Edit 모델
_{Qwen2.5-VL based Image Edit model}| T2I · I2I · Edit(최대 3장) · Inpaint · **Outpaint** · Faceswap · **Angle** · **Upscale**
_{T2I · I2I · Edit(up to 3 images) · Inpaint · **Outpaint** · Faceswap · **Angle** · **Upscale**}| | **Krea 2 ONE STUDIO (TJ)** | Krea.ai 이미지 생성 모델
_{Krea.ai image generation model}| T2I · I2I · **ControlNet(depth/canny 🧪)** · **IDENTITY 🧪** · **Upscale** | | **SDXL ONE STUDIO (TJ)** 🧪 | SDXL Checkpoint / Separate UNET 모델
_{SDXL Checkpoint / Separate UNET model}| T2I · I2I · Inpaint · Outpaint · Upscale *(테스트 버전 / Test Version)* | | **MiniMax H3 ONE STUDIO (TJ)** 🧪 | MiniMax H3 영상+오디오 생성 모델
_{MiniMax H3 video + audio model}| Text / First-Last / Reference · **클립 릴레이 + 자동 합본** · 라이브 프리뷰 *(실험적 / Experimental)* | | **Anima ONE STUDIO (TJ)** 🆕 | Anima (ComfyUI 네이티브 애니메이션풍 이미지 모델)
_{Anima (ComfyUI-native anime-style image model)}| T2I · Inpainting · Any Control to Image · Depth Control to Image · **Turbo LoRA** · **인라인 마스크 페인터**
_{T2I · Inpainting · Any Control to Image · Depth Control to Image · **Turbo LoRA** · **inline mask painter**}| > **언어 지원**: 모든 노드의 Settings에서 한국어 / English 전환 가능 > **Language Support**: Korean / English can be selected in Settings for every node > **🔗 PromptDB 파이프 연동 (TJ_NODE)**: 모든 ONE STUDIO 노드에 `pipe` 입력이 있어, [`ComfyUI-TJ_NODE`](https://github.com/designloves2/ComfyUI-TJ_NODE)의 **`PromptDBLoader(TJ)`** 에서 고른 기록을 **소켓 하나로** 받아 **생성 시점에 적용**합니다. 적용 필드: 프롬프트(pos/neg) · seed · steps · cfg · sampler · scheduler. **모델은 파이프에서 적용하지 않고 각 노드가 자기 설정 모델을 사용**합니다(노드마다 필요한 모델 계열이 달라서). 파이프에 있는 값만 오버라이드하고 없는 값은 노드 설정을 그대로 쓰며, 노드 UI는 변경되지 않습니다. TJ_NODE 미설치 시 해당 소켓만 비활성이고 노드는 정상 동작합니다. (TJ_NODE v2.10.1+) > **🔗 PromptDB pipe (TJ_NODE)**: every ONE STUDIO node has a `pipe` input that receives a selected record from **`PromptDBLoader(TJ)`** and applies it **at generation time** — prompt (pos/neg), seed, steps, cfg, sampler, scheduler. **The model is NOT taken from the pipe**; each node keeps its own configured model (different nodes need different model families). Only fields present in the pipe override the node's settings, the rest keep the node's own values, and the node UI is never changed. No hard dependency: if TJ_NODE isn't installed the socket is simply inactive. (TJ_NODE v2.10.1+) > > ![PromptDBLoader(TJ) → Flux.2 Klein ONE STUDIO (TJ) pipe connection](docs/promptdb_pipe_connection.png) > _`PromptDBLoader(TJ)`의 `pipe` 출력을 ONE STUDIO 노드의 `pipe` 입력에 연결한 예시 (Flux.2 Klein) / example `pipe` connection (Flux.2 Klein)_ > > ![PromptDBLoader(TJ) selected row detail](docs/promptdb_pipe_row_detail.png) > _선택된 기록의 상세 필드(model · seed · steps · cfg · sampler · scheduler · extra_settings · note) — model은 파이프로 전달되지 않음 / selected record's detail fields — model is not carried over the pipe_ --- ## 설치 방법 ## Installation ### ComfyUI Manager (권장) ### ComfyUI Manager (recommended) ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` 검색 후 설치 ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` search and install ### 수동 설치 ### Manual Installation ```bash cd ComfyUI/custom_nodes git clone https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE.git ``` ComfyUI를 재시작하면 Add Node 메뉴에서 모든 노드를 찾을 수 있습니다. ComfyUI After restarting all nodes will be available in the Add Node menu. --- ## 필수 커스텀 노드 ## Required Custom Nodes > **아래 노드들을 수동으로 설치하기 번거롭다면 자동 설치 스크립트를 사용하세요.** > **Use the automatic installation script if installing the nodes below manually is inconvenient..** ### ⚡ 자동 설치 (권장) ### ⚡ Automatic Installation (recommended) 이 패키지 폴더 안에 포함된 스크립트를 실행하면 필수 노드를 한 번에 설치합니다. Run the script included in this package folder to install all required nodes at once.. **Windows:** ``` install_requirements.bat ← 더블클릭으로 실행 ``` **Mac / Linux:** ```bash chmod +x install_requirements.sh ./install_requirements.sh ``` - 이미 설치된 노드는 자동으로 건너뜁니다 - Already installed nodes are skipped automatically - `requirements.txt`가 있는 노드는 pip install까지 자동 처리 - `requirements.txt`Nodes with requirements.txt are automatically processed through pip install - 완료 후 ComfyUI를 재시작하면 모든 노드가 로드됩니다 - Restart ComfyUI after completion to load all nodes ### 수동 설치 목록 ### Manual Installation List | 노드
_Node| 용도
_Purpose| 필수 대상
_{Required For}| |---|---|---| | [ComfyUI-Impact-Pack](https://github.com/ltdrdata/ComfyUI-Impact-Pack) | FaceDetailer — 얼굴 감지·재생성·블렌드 핵심 엔진
_{FaceDetailer — core engine for face detection, regeneration, and blending}| Z-Image Face Redraw | | [ComfyUI-Impact-Subpack](https://github.com/ltdrdata/ComfyUI-Impact-Subpack) | Impact Pack 필수 서브팩 (함께 설치 필요)
_{Impact Pack required subpack (must be installed together)}| Z-Image Face Redraw | | [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) | FluxKVCache · ImagePadKJ · FluxKontext 관련 노드
_{FluxKVCache · ImagePadKJ · FluxKontext related nodes}| Klein · QE2511 | | [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) | GGUF 형식 모델 로딩
_{GGUF format model loading}| 선택 (GGUF 사용 시)
_{selection (GGUF when used)}| | [ComfyUI_FaceAnalysis](https://github.com/cubiq/ComfyUI_FaceAnalysis) | Faceswap 모드 얼굴 감지
_{Faceswap mode face detection}| Klein · QE2511 Faceswap | | [ComfyUI-RMBG](https://github.com/1038lab/ComfyUI-RMBG) | 배경 제거
_{background removal}| Z-Image RE-BG | | [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | ControlNet 전처리기 (depth/canny)
_{ControlNet preprocessor (depth/canny)}| Z-Image ControlNet · Krea2 ControlNet 🧪 | | [ComfyUI-SeedVR2](https://github.com/numz/ComfyUI-SeedVR2_VideoUpscaler) | SeedVR2 AI 업스케일 노드
_{SeedVR2 AI upscaling node}| 전체 노드 Upscale 모드
_{Upscale mode for all nodes}| | [comfyui-krea2-controlnet](https://github.com/facok/comfyui-krea2-controlnet) 🧪 | Krea2 Control LoRA (depth)
_{Krea2 Control LoRA (depth)}| Krea2 ControlNet Depth | | [comfyui-krea2edit](https://github.com/lbouaraba/comfyui-krea2edit) 🧪 | Krea2 in-context 편집
_{Krea2 in-context edit}| Krea2 IDENTITY | | [ComfyUI-NK2E](https://github.com/Nynxz/ComfyUI-NK2E) 🧪 | Krea2 NK2E in-context (canny)
_{Krea2 NK2E in-context (canny)}| Krea2 ControlNet Canny | | [ComfyUI-MiniMaxH3-Cache](https://github.com/lihaoyun6/ComfyUI-MiniMaxH3-Cache) 🧪 | 스텝 재사용 캐시
_{step-reuse cache}| MiniMax H3 (선택)
_optional| | [ComfyUI-MiniMaxH3-FirstBlockCache](https://github.com/duckyshell/ComfyUI-MiniMaxH3-FirstBlockCache) 🧪 | 스텝 재사용 캐시 (대안)
_{step-reuse cache (alt)}| MiniMax H3 (선택)
_optional| | [ComfyUI-PlagueKind-Nodes](https://github.com/PlagueKind/ComfyUI-PlagueKind-Nodes) 🧪 | H3 SLA Attention (블록-스파스)
_{H3 SLA Attention (block-sparse)}| MiniMax H3 (선택)
_optional| | [ComfyUI-sol-attn](https://github.com/Saganaki22/ComfyUI-sol-attn) 🧪 | H3 전용 Sol 어텐션 · Fused Modulation
_{H3-specific Sol attention + AdaLN fusion}| MiniMax H3 (선택)
_optional| | [ComfyUI-MiniMax-H3-Turbo](https://github.com/Larryvrh/ComfyUI-MiniMax-H3-Turbo) 🧪 | Turbo LoRA · Turbo 샘플러
_{turbo LoRA + sampler}| MiniMax H3 Accel=Turbo | | [ComfyUI-SolAttn_triton](https://github.com/kijai/ComfyUI-SolAttn_triton) 🧪 | SolAttn 가속
_{SolAttn acceleration}| MiniMax H3 Accel=SolAttn (기본값)
_default| | [ComfyUI-Spectrum-MiniMax-H3](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3) 🧪 | Spectrum 가속
_{Spectrum acceleration}| MiniMax H3 Accel=Spectrum | | [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) 🧪 | 레퍼런스 **비디오** 입력
_{reference video inputs}| MiniMax H3 Reference 모드
_{Reference mode}| | [Nvidia RTX Nodes](https://github.com/Comfy-Org/Nvidia_RTX_Nodes_ComfyUI) 🧪 | RTX Video Super Resolution | MiniMax H3 Upscale=RTX VSR | --- ## Z-Image ONE STUDIO — 기능 상세 ## Z-Image ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **INPAINT** | 내장 마스크 에디터로 특정 영역만 재생성 (DifferentialDiffusion)
_{regenerate only selected areas using the built-in mask editor (DifferentialDiffusion)}| | **OUTPAINT** | 이미지 캔버스 확장 후 빈 영역 인페인트
_{extend the image canvas and inpaint empty areas}| | **RE-BG** | RMBG로 서브젝트 분리 → 배경 완전 재생성 (경계선 없음)
_{RMBGseparate the subject with RMBG and completely regenerate the background (without boundary artifacts)}| | **CONTROLNET** | Depth / Canny / Pose / HED / MLSD 레퍼런스 가이드 생성
_{Depth / Canny / Pose / HED / MLSD generate a reference guide}| | **FACE REDRAW** | 얼굴 자동 감지 → 크롭 → LoRA 재생성 → 원본에 블렌드
_{automatically detect the face, crop it, regenerate with LoRA, and blend it into the original}| | **UPSCALE** | SeedVR2 AI 업스케일 — DiT 모델 기반 초고해상도 변환
_{SeedVR2 AI — DiT ultra-high-resolution conversion using a DiT model}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [z_image_turbo_bf16](https://huggingface.co/Comfy-Org/z_image_turbo) | | Text Encoder | `models/text_encoders/` | [qwen_3_4b](https://huggingface.co/Comfy-Org/z_image_turbo) | | VAE | `models/vae/` | [ae.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo) | | ControlNet (선택)
_{ControlNet (selection)}| `models/controlnet/` | [Z-Image-Turbo-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union) | --- ## Flux.2 Klein ONE STUDIO — 기능 상세 ## Flux.2 Klein ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **EDIT** | 레퍼런스 이미지 1~5장 기반 멀티 레퍼런스 편집
_{multi-reference editing based on 1–5 reference images}| | **PAINT** | 내장 마스크 에디터로 특정 영역 재생성 + Outpaint 지원
_{built-in mask editor regenerate selected areas with Outpaint support}| | **FACESWAP** | BFS 얼굴 LoRA를 사용한 얼굴 교체·재생성
_{BFS face replacement and regeneration using a BFS face LoRA}| | **UPSCALE** | SeedVR2 AI 업스케일 — DiT 모델 기반 초고해상도 변환
_{SeedVR2 AI — DiT ultra-high-resolution conversion using a DiT model}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [BFL FLUX.2 Collection](https://huggingface.co/collections/black-forest-labs/flux2) | | Text Encoder (9B) | `models/text_encoders/` | [Comfy-Org 9B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b) | | Text Encoder (4B) | `models/text_encoders/` | [Comfy-Org 4B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-4b) | | VAE | `models/vae/` | [Comfy-Org 9B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b) | | BFS LoRA (Faceswap) | `models/loras/` | [BFS-Best-Face-Swap](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap) | > **KV Cache**: 파일명에 `kv`가 포함된 모델은 자동으로 FluxKVCache 노드를 활성화합니다. > **KV Cache**: Models whose filenames contain `kv` automatically FluxKVCache enable the node. --- ## Qwen Image Edit 2511 ONE STUDIO — 기능 상세 ## Qwen Image Edit 2511 ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트로 이미지 생성
_{generate an image from text}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **EDIT** | 텍스트 프롬프트로 이미지 편집. 원본 + 참조 이미지 최대 3장 지원
_{edit images using a text prompt. supports the original plus up to three reference images}| | **PAINT** | 마스크 영역 인페인트. Outpaint(캔버스 확장) 포함
_{inpaint masked areas. Outpaint(canvas expansion) included}| | **FACESWAP** | BFS LoRA를 활용한 얼굴 교체. 자동 기본 프롬프트 제공
_{BFS LoRAface replacement using BFS LoRA. provides an automatic default prompt}| | **ANGLE** | 3D 씬에서 카메라 앵글(H/V/Z) 드래그 조절. Camera Angle LoRA는 ⚙ Settings에서 설정
_{3D scene camera angle(H/V/Z) drag control. Camera Angle LoRAis configured in ⚙ Settings}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files/diffusion_models) | | Text Encoder | `models/text_encoders/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/text_encoders) | | VAE | `models/vae/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/vae) | | Lightning LoRA (선택)
_{Lightning LoRA (selection)}| `models/loras/` | [Qwen-Image-Edit-2511-Lightning](https://huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning/tree/main) | | Camera Angle LoRA (선택)
_{Camera Angle LoRA (selection)}| `models/loras/` | [Multi Angle LoRa](https://huggingface.co/fal/Qwen-Image-Edit-2511-Multiple-Angles-LoRA) | | BFS LoRA (Faceswap 필수)
_{BFS LoRA (Faceswap required)}| `models/loras/` | [BFS-Best-Face-Swap](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap) | > **내부 의존 노드**: `FluxKontextImageScale` · `TextEncodeQwenImageEditPlus` · `FluxKontextMultiReferenceLatentMethod` — ComfyUI-KJNodes에 포함 > **Internal Dependency Nodes**: `FluxKontextImageScale` · `TextEncodeQwenImageEditPlus` · `FluxKontextMultiReferenceLatentMethod` — ComfyUI-KJNodesincluded in --- ## Krea 2 ONE STUDIO — 기능 상세 ## Krea 2 ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트로 이미지 생성 (+ ControlNet depth/canny 🧪)
_{generate an image from text (+ ControlNet depth/canny 🧪)}| | **I2I** | 소스 이미지 기반 변형 생성 (+ ControlNet depth/canny 🧪)
_{source image-based transformation (+ ControlNet depth/canny 🧪)}| | **IDENTITY** 🧪 | 지시문 기반 인물 정체성/외형 편집
_{instruction-based identity / appearance editing}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/diffusion_models) | | Text Encoder | `models/text_encoders/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/text_encoders) | | VAE | `models/vae/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/vae) | ### 🧪 IDENTITY · ControlNet (depth / canny) — 실험적 기능 ### 🧪 IDENTITY · ControlNet (depth / canny) — Experimental Features > ⚠️ **실험적 기능 · 오류 가능성 있음 (Experimental — may produce errors or unexpected results)** > IDENTITY 탭과 ControlNet(depth/canny)은 외부 커스텀 노드 + 별도 LoRA에 의존하는 실험적 기능입니다. 결과 품질이 일정하지 않을 수 있고, 노드/모델 미설치 시 생성이 실패합니다. depth·canny는 **LoRA 기반**이라 픽셀 단위로 정확하지 않습니다. > The IDENTITY tab and ControlNet (depth/canny) are experimental and depend on external custom nodes + separate LoRAs. Output quality can be inconsistent, and generation fails if the required nodes/models are missing. Because depth/canny are **LoRA-based**, they are not pixel-accurate. > > - **Depth** = 전체 구도·프레이밍·스케일을 잡음(세밀한 포즈는 느슨) / captures overall composition·framing·scale (loose on fine pose) > - **Canny** = 윤곽선을 정확히 고정해 포즈·얼굴 방향·실루엣 재현 / locks contours for faithful pose·face-direction·silhouette **필수 커스텀 노드 (Required custom nodes)** | 노드
_Node| 기능
_{Used for}| |---|---| | [comfyui-krea2edit](https://github.com/lbouaraba/comfyui-krea2edit) | IDENTITY (`Krea2EditModelPatch` · `Krea2EditGroundedEncode`) | | [comfyui-krea2-controlnet](https://github.com/facok/comfyui-krea2-controlnet) | ControlNet **Depth** (`Krea2ControlLoRALoader` · `…ImageEncode` · `…Apply`) | | [ComfyUI-NK2E](https://github.com/Nynxz/ComfyUI-NK2E) | ControlNet **Canny** (`NK2EInContextEditNode`) | | [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | depth/canny 전처리기 (`DepthAnythingV2Preprocessor` · `CannyEdgePreprocessor`) | **필수 LoRA / 모델 (Required LoRAs / models) — `models/loras/` 에 배치** | 기능
_Feature| 파일
_File| 다운로드
_Download| |---|---|---| | IDENTITY | `krea2_identity_edit_v1_2.safetensors` | [conradlocke/krea2-identity-edit](https://huggingface.co/conradlocke/krea2-identity-edit) | | Depth ControlNet | depth control LoRA (예: `depth-control-lora.safetensors`) | [Patil/Krea-2-depth-controlnet](https://huggingface.co/Patil/Krea-2-depth-controlnet) | | Canny ControlNet | NK2E canny LoRA (예: `NK2E-canny-v0.1.safetensors`) | [nynxz/NK2E](https://huggingface.co/nynxz/NK2E) | > **Depth 전처리 모델 자동 다운로드**: depth 사용 시 `depth_anything_v2_vitl.pth`(Large, 권장)가 첫 실행에 `comfyui_controlnet_aux/ckpts/depth-anything/…` 로 자동 다운로드됩니다. (vitb/vits도 선택 가능. **vitg(Giant)는 저장소가 비공개라 지원 안 함.**) > **Depth preprocessor auto-download**: on first use, `depth_anything_v2_vitl.pth` (Large, recommended) is auto-downloaded to `comfyui_controlnet_aux/ckpts/depth-anything/…`. (vitb/vits selectable too. **vitg (Giant) is unsupported — its repo is gated.**) **설정 방법 (Setup)** 1. 위 커스텀 노드 설치 후 ComfyUI 재시작 / install the nodes above, restart ComfyUI 2. LoRA 파일을 `models/loras/` 에 배치 / place the LoRA files in `models/loras/` 3. ⚙ **Settings** 에서 IDENTITY LoRA, Depth/Canny Control LoRA **파일만 등록** / register only the LoRA **files** in Settings 4. 조절값(strength·임계값·depth 모델·해상도 등)은 **사이드 메뉴 CONTROLNET 패널**에서 직접 조절 / adjust all tuning values in the **side-menu CONTROLNET panel** --- ## SDXL ONE STUDIO — 기능 상세 🧪 ## SDXL ONE STUDIO — Feature Details 🧪 > 🧪 **테스트 버전 (Test / Beta Version)** > SDXL ONE STUDIO는 현재 테스트 단계입니다. 핵심 기능은 동작하지만 UI 및 옵션이 향후 변경될 수 있습니다. > SDXL ONE STUDIO is currently in the test stage. Core features are functional, but the UI and options may change in future versions. ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **INPAINT** | 내장 풀스크린 마스크 에디터 (줌 1x–32x · 팬 · 브러시/지우개) — VAEEncodeForInpaint로 완전 마스킹
_{built-in full-screen mask editor (zoom 1x–32x · pan · brush/eraser) — fully masked with VAEEncodeForInpaint}| | **OUTPAINT** | 이미지 캔버스 확장 후 빈 영역 인페인트. 비교 슬라이더에서 패딩된 원본 미리보기 제공
_{extend the image canvas and inpaint empty areas. padded original preview in compare slider}| | **UPSCALE** | ESRGAN AI 업스케일 (latent 확대 → Refiner KSampler 정제)
_{ESRGAN AI upscale (latent upscale → Refiner KSampler refinement)}| ### 모델 로딩 방식 ### Model Loading Mode SDXL ONE STUDIO는 Settings에서 두 가지 로딩 방식을 지원합니다. SDXL ONE STUDIO supports two model loading modes in Settings. | 방식
_Mode| 설명
_Description| |---|---| | **CKPT** | 단일 Checkpoint 파일 (`models/checkpoints/`) — 가장 간단한 방식
_{single Checkpoint file (`models/checkpoints/`) — simplest setup}| | **Separate (UNET)** | UNET + DualCLIP(L/G) + VAE 분리 로딩 — GGUF·FP8 경량 모델 지원
_{separate UNET + DualCLIP(L/G) + VAE loading — supports GGUF·FP8 lightweight models}| > **Refiner**: CKPT / Separate 방식 모두 별도 Refiner Checkpoint를 항상 설정할 수 있습니다. Refiner는 `CheckpointLoaderSimple`로 독립 로딩됩니다. > **Refiner**: In both CKPT and Separate modes, a separate Refiner Checkpoint can always be configured. The Refiner is loaded independently via `CheckpointLoaderSimple`. ### 주요 기능 ### Key Features | 기능
_Feature| 설명
_Description| |---|---| | **📋 프롬프트 템플릿**
_{📋 Prompt Template}| 자주 쓰는 프롬프트 저장·불러오기 (Klein 공유 템플릿 DB 사용)
_{save and load frequently used prompts (shared template DB with Klein)}| | **🔍 프롬프트 확대 편집**
_{🔍 Prompt Expand Edit}| 전체화면 편집 팝업. TJ_NODE 설치 시 ✨ Enhance · 🖼 Image→Prompt 자동 활성화
_{fullscreen edit popup. TJ_NODE install enables ✨ Enhance · 🖼 Image→Prompt}| | **CKPT ↔ UNET 표시기**
_{CKPT ↔ UNET Indicator}| 현재 로딩 방식을 상단 배지로 표시. 방식 전환 시 즉시 업데이트
_{display current loading mode as a top badge. Updates instantly on mode change}| | **⇌ 비교 슬라이더**
_{⇌ Compare Slider}| Outpaint: 패딩된 원본 vs 결과 / Inpaint: 원본 vs 마스킹 결과
_{Outpaint: padded original vs result / Inpaint: original vs masked result}| | **마스크 에디터**
_{Mask Editor}| 팝업 풀스크린 에디터 — 줌·팬·브러시/지우개·크기 슬라이더 내장
_{popup fullscreen editor — zoom · pan · brush/eraser · size slider built-in}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 비고
_Notes| |---|---|---| | **SDXL Checkpoint** (CKPT 방식) | `models/checkpoints/` | 일반 SDXL .safetensors 파일
_{standard SDXL .safetensors file}| | **SDXL UNET** (Separate 방식) | `models/diffusion_models/` | GGUF / FP8 경량 파일도 지원
_{GGUF / FP8 lightweight files also supported}| | **CLIP-L** (Separate 방식) | `models/text_encoders/` | SDXL dual-encoder: clip_l
_{SDXL dual-encoder: clip_l}| | **CLIP-G** (Separate 방식) | `models/text_encoders/` | SDXL dual-encoder: clip_g
_{SDXL dual-encoder: clip_g}| | **VAE** (Separate 방식) | `models/vae/` | sdxl_vae.safetensors 등
_{sdxl_vae.safetensors etc.}| | **Refiner Checkpoint** (선택)
_{Refiner Checkpoint (optional)}| `models/checkpoints/` | SDXL-Refiner 계열 모델
_{SDXL-Refiner series model}| | **ESRGAN Upscale** (Upscale 시 필수)
_{ESRGAN Upscale (required for Upscale)}| `models/upscale_models/` | 4x-UltraSharp 등
_{4x-UltraSharp etc.}| --- ## 공통 기능 ## Common Features ### 설정 패널 (⚙ Settings) ### Settings Panel (⚙ Settings) - **Diffusion Model / Text Encoder / VAE** 드롭다운 선택 - **Diffusion Model / Text Encoder / VAE** dropdown selection - **↻ Refresh Models** — 모델 폴더 재스캔 (ComfyUI 재시작 없이 새 파일 인식) - **↻ Refresh Models** — rescan model folders (recognize new files without restarting ComfyUI) - **언어 / Language** — 한국어 / English 전환 (페이지 새로고침 적용) - ** / Language** — Korean / English before (applied after page refresh) - **Negative Prompt** — 전체 모드 공통 적용 - **Negative Prompt** — applied to all modes - **Prompt Suffix** — 프롬프트 뒤에 자동 추가 - **Prompt Suffix** — automatically appended to the prompt - **Save Folder** — `ComfyUI/output/` 내부 하위 저장 폴더 지정 - **Save Folder** — `ComfyUI/output/` specify a subfolder under ComfyUI/output - **모델 오버라이드 슬롯** — Primitive(String) 노드 연결로 설정 드롭다운 우선 적용 - **Model Override Slots** — Primitive(String) connect a Primitive(String) node to override the Settings dropdown ### SeedVR2 Upscale 모델 (전체 노드 공용) ### SeedVR2 Upscale model (shared by all nodes) | 경로
_Path| 파일
_File| 다운로드
_Download| |---|---|---| | `models/SEEDVR2/` | DiT + VAE 모델
_{DiT + VAE model}| [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | ### LoRA - 최대 3개 LoRA 체인 (Faceswap 모드는 1개) - up to three LoRA chains (Faceswap one in Faceswap mode) - `.safetensors` 헤더에서 트리거 워드 자동 추출 및 표시 - `.safetensors` automatically extract and display trigger words from the .safetensors header - LoRA 교체 시 트리거 워드 자동 초기화 후 새 LoRA 트리거 워드 재로드 - when changing LoRA, clear the old trigger word and reload the new LoRA trigger word - ON/OFF 토글로 개별 활성화 - ON/OFF individually enable with the ON/OFF toggle - Strength 0~2 조절 (0 값 정상 저장) - Strength 0~2 adjustment (0 value is saved correctly) ### 갤러리 (🖼 Gallery) ### Gallery (🖼 Gallery) - 저장된 이미지 타일 보기 (무한 스크롤, 정사각형 그리드) - view saved images as tiles (infinite scrolling, square grid) - 즐겨찾기(★) / 삭제 / 폴더 열기 / Send to(모드에 이미지 전달) - favorite(★) / delete / open folder / Send to(send image to a mode) - ESC 키로 닫기 - ESC close with the ESC key ### 비교 슬라이더 (⇌ Compare) ### Comparison Slider (⇌ Compare) - 생성 전 원본과 생성 후 결과를 드래그로 나란히 비교 - drag the slider to compare the original and generated result side by side ### 단축키 ### Keyboard Shortcuts | 키
_Key| 동작
_Action| |---|---| | `ESC` | 열린 팝업 / 갤러리 / 오버레이 닫기
_{close open popups, Gallery, or overlays}| --- ## MiniMax H3 ONE STUDIO — 기능 상세 🧪 ## MiniMax H3 ONE STUDIO — Feature Details 🧪 > ⚠️ **실험적 기능 · 오류 가능성 있음 (Experimental — may produce errors)** > 영상+오디오 생성 노드입니다. 외부 커스텀 노드와 별도 모델에 의존하며, 긴 영상은 클립을 이어 붙이는 방식이라 결과가 완벽하지 않을 수 있습니다. > Video + audio node. It depends on external custom nodes and separate models, and long videos are assembled from chained clips, so results are not seamless. ### 왜 클립으로 나누는가 / Why clips MiniMax H3는 프레임 수가 **17k+5 격자**에만 떨어지고 한 번에 만들 수 있는 길이가 제한적입니다(VRAM). 이 노드는 긴 프롬프트를 **클립 단위로 나눠 순차 생성**하고, 각 클립을 개별 저장한 뒤 마지막에 **하나로 합칩니다**. 클립마다 큐를 새로 제출하고, 클립 사이와 실행이 끝날 때 VRAM을 명시적으로 해제합니다(ComfyUI는 프롬프트 사이에 모델을 그대로 들고 있습니다). MiniMax H3 only accepts frame counts on a **17k+5 grid** and a single pass is VRAM-limited. This node renders a long prompt as **sequential clips**, saves each one, then **stitches them into one file**. Each clip is its own queue submission, and VRAM is freed explicitly between clips and once the run ends — ComfyUI itself keeps models resident between prompts. > ⚠️ **이미지 노드의 RUN 큐와는 다른 구조입니다 — 브라우저 탭이 계속 열려 있어야 합니다.** > 이미지 생성 노드는 ComfyUI 상단 RUN으로 그래프 전체를 서버에 한 번에 제출하므로, 브라우저를 닫아도 서버가 큐에 쌓인 걸 계속 처리합니다(이미지는 느려도 보통 2분 내외로 끝나서 체감이 잘 안 될 뿐입니다). 반면 MiniMax H3의 클립 릴레이(그리고 ⏭ Next Gen 대기 큐)는 **다음 클립의 그래프를 "이전 클립의 실제 결과"를 보고 그때그때 만들기 때문에** 미리 통째로 제출해둘 수가 없고, 그 판단을 브라우저 쪽 JS가 매 클립마다 내립니다. 그래서 지금 실행 중인 클립 하나는 브라우저를 닫아도 서버에서 끝까지 돌지만, **그다음 클립을 이어서 큐에 넣어줄 코드가 사라져 거기서 멈춥니다.** 영상은 클립이 여러 개면 총 소요 시간이 수 분~수 시간까지 갈 수 있으니, 탭을 (백그라운드/최소화는 괜찮지만) 완전히 닫지 마세요. **컴퓨터/모니터가 절전모드(잠자기)로 들어가는 것도 탭을 닫는 것과 같은 문제**입니다 — 그 시점의 클립은 서버에서 끝까지 돌지만 다음 클립을 이어서 넣어줄 브라우저 쪽 실행이 멈추므로, 긴 런을 돌릴 때는 절전모드를 꺼두세요. (완화책으로 실행 중에는 거의 무음에 가까운 낮은 볼륨의 오디오를 백그라운드에서 계속 재생해, 브라우저/OS가 탭을 완전히 절전 상태로 넘기지 않도록 유도합니다 — 100% 보장은 아니니 긴 런은 절전모드 자체를 꺼두는 쪽을 권장합니다.) 페이지를 그냥 **새로고침**한 경우에는 진행 상황이 저장되어 있어 자동으로 이어집니다. > **This is a different structure from the RUN queue on image nodes — the browser tab has to stay open.** Image nodes submit the whole graph to the server in one shot via RUN, so the server keeps processing the queue even with the browser closed (this is easy to miss since an image usually finishes within ~2 minutes regardless). MiniMax H3's clip relay (and the ⏭ Next Gen queue) is different: the next clip's graph depends on the *actual result* of the previous one, so it can't be submitted upfront — that decision is made by the browser's own JS, clip by clip. The clip currently in flight will finish server-side even if you close the tab, but nothing is left to queue the next one, so the run stops there. A video run with several clips can take anywhere from minutes to hours, so keep the tab open (backgrounded/minimized is fine, just not closed). **The computer/monitor going to sleep causes the exact same problem as closing the tab** — the clip in flight still finishes server-side, but nothing is left running in the browser to queue the next one, so disable sleep for a long run. (As a mitigation, a near-silent low-volume tone plays in the background for the whole run, nudging the browser/OS away from fully suspending the tab — not a guarantee, so disabling sleep is still the reliable option for a long run.) A plain page **refresh** is safe — saved progress picks the run back up automatically. ### 지원 모드 / Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **Text only** (T2VA) | 프롬프트만으로 생성
_{prompt only}| | **First/Last Frame** (FL2VA) | 시작(+선택적 끝) 키프레임 지정
_{start (+optional end) keyframe}| | **Reference** (REF2VA) | 레퍼런스 이미지 최대 9장, 프롬프트에서 `

Name	Type	Default	Description
images	IMAGE		—
strength	COMBO	MEDIUM	Deblur intensity. Resolution is never changed — this sharpens, it does not upscale.

RTX Deblur (TJ)

Inputs (2)

Outputs (1)