# 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, **Qwen Image 2.1 ONE STUDIO**, Krea 2 ONE STUDIO, **SDXL ONE STUDIO**, Minimax H3 ONE STUDIO, **Anima ONE STUDIO**, **MusicMaker ONE STUDIO**, **ITDA ONE STUDIO** 열 가지 노드를 단일 패키지로 제공합니다. > **ComfyUI all-in-one generation UI package** — Z-Image ONE STUDIO, Flux.2 Klein ONE STUDIO, Qwen Image Edit 2511 ONE STUDIO, **Qwen Image 2.1 ONE STUDIO**, Krea 2 ONE STUDIO, **SDXL ONE STUDIO**, Minimax H3 ONE STUDIO, **Anima ONE STUDIO**, **MusicMaker ONE STUDIO**, **ITDA ONE STUDIO** — ten 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. > > 🆕 **MiniMax H3 Prompt Edit이 크게 좋아졌습니다.** 클립마다 **시간 오버라이드**(1초~15초, 0.5초 단위로 실제 렌더 길이에 맞춰 정리)를 줄 수 있고, **CLIPS** 목록에 클립별 누적 시간과 샷 범위(`[shot 1] 0~4.5`)가 보입니다(One-Take에서는 겹침을 뺀 `stitched` 시간도). 오버라이드한 클립은 주황, 에셋 라이브러리 오버라이드는 핑크로 표시됩니다. 클립을 나누면 각 클립의 샷 번호와 시간이 `[Shot 1]`부터 다시 시작하고(시간은 0.5초 단위), 클립별 전체 브리프(헤더 / 샷 / 사운드·음악)는 각각 THIS CLIP 칸으로 들어갑니다. ✨ Prompt Write · 🔧 Prompt Refine은 ✓ Done 옆에 항상 보입니다. > > 🆕 **MiniMax H3 Prompt Edit got a big upgrade.** Each clip can have its own **time override** (1 s to 15 s, tidied to half seconds that match the length really rendered), and the **CLIPS** list shows each clip's running clock and shot ranges (`[shot 1] 0~4.5`), plus the `stitched` time without the overlap in One-Take. A clip with an override is orange, one with an Asset Library override is pink. Splitting restarts the shot numbers and times of every clip from `[Shot 1]` (times in half seconds), and a full brief per clip (header / shots / sound-music) goes into that clip's own THIS CLIP boxes. ✨ Prompt Write and 🔧 Prompt Refine stay beside ✓ Done. > > 🆕 **원테이크 프롬프트 규칙.** Continuity ▸ One-Take (latent)의 새 체크 **Write prompts with the One-Take rules**를 켜면 LLM이 [원테이크 교본](ONE_TAKE_Guide_Korean/ONE_TAKE_Guide_Korean.md)의 규칙(클립당 `[Shot 1]`만, 클립 끝 상태를 다음 클립 시작에 그대로 복사, 빠른 동작은 클립 끝 1.7초 전에 마감)으로 브리프를 씁니다. 프롬프트에 "원테이크 / one take / one-take"가 있으면 이 체크와 One-Take 모드가 자동으로 켜집니다. 왼쪽 메뉴의 **Canvas · Clip length · Preset · Steps**도 접이식 아코디언이 되었고, Continuity 설명은 툴팁으로 옮겼습니다. > > 🆕 **One-Take prompt rules.** The new box **Write prompts with the One-Take rules** under Continuity ▸ One-Take (latent) makes the LLM write briefs by the rules of the [One-Take guide](ONE_TAKE_Guide_Korean/ONE_TAKE_Guide_Korean.md): one `[Shot 1]` per clip, each clip's end state copied into the start of the next, fast actions finished 1.7 s before a clip ends. A prompt that says "원테이크 / one take / one-take" turns the box and the One-Take mode on by itself. **Canvas, Clip length, Preset and Steps** in the left menu are accordions now, and the Continuity explanations are tooltips. > > 🆕 **MiniMax H3 Image to Video (F/L)**: 첫/마지막 프레임도 Reference처럼 **Files / Gallery** 또는 **Asset Library** 중 하나만 고릅니다. Prompt Edit에 에셋 프레임이 보이고, Prompt Write/Refine이 그 이미지를 LLM에 보냅니다. > > 🆕 **MiniMax H3 Image to Video (F/L)**: First / Last frames now pick one source, **Files / Gallery** or **Asset Library**, like Reference. Prompt Edit shows the library frames and Prompt Write / Refine send them to the vision model. > > 🆕 **ITDA ONE STUDIO**: 렌더 결과를 ITDA 갤러리에 저장하고(목록·삭제·가져오기), 앱 설정이 서버에 저장되며, 설정·프로젝트·저장·갤러리가 **☰ Menu** 하나로 모였습니다. > > 🆕 **ITDA ONE STUDIO**: renders are saved to the ITDA gallery (list, delete, import), app settings are stored on the server, and Settings / Project / Save / Gallery now live in one **☰ Menu**. > > 🆕 **이미지 노드 미리보기·비교·갤러리 확대에서 휠 = 확대, 왼쪽 드래그 = 이동, 더블클릭 = 맞춤.** 비교 바는 그대로 있습니다. UPSCALE에 **VOSR**가 SeedVR2 옆에 추가되었고(Anima에도 UPSCALE 모드 추가), Qwen 2.1 POSE에 **Preview & Angle** 3D 뷰어와 **Load 3D Pose** 목록이 생겼습니다. 갤러리에는 3D 포즈 그림이 더 이상 섞이지 않습니다. > > 🆕 **Wheel = zoom, left-drag = pan, double-click = fit** in previews, Compare and the enlarged gallery picture of the image nodes; the compare bar stays put. UPSCALE gets **VOSR** next to SeedVR2 (Anima gains an UPSCALE mode), and Qwen 2.1 POSE gets the **Preview & Angle** 3D viewer and a **Load 3D Pose** list. Galleries no longer show the 3D pose pictures. > > 🆕 **참조 영상이 훨씬 가벼워집니다.** Reference 모드의 참조 영상은 원본 크기 그대로 모델에 들어가 프레임마다 토큰이 되기 때문에 큰 영상은 첫 스텝이 시작되기 전에 매우 오래 걸릴 수 있었습니다. 이제 영상 타일의 **mp** 칸(그리고 Asset 탭 영상 에셋의 **mp (downscale)**)으로 큐에 들어갈 때 지정한 MP까지 줄입니다(원본 파일은 그대로, 더 작은 영상은 키우지 않음). Asset 탭 영상 에셋에는 **구간(in/out)**, **Video sound**도 생겼습니다. **Face Refine의 Turbo**는 이제 메인 Turbo 섹션과 같은 선택(None / Turbo LoRA (Basic) / larryvrh / SLA)과 자기만의 LoRA·steps를 씁니다. 7+1에는 2단계 **Activation chunk rows** 칸이 추가되었습니다. > > 🆕 **Reference videos get much lighter.** A reference video went to the model at its own size and every frame became tokens, so a large clip could take very long before the first step. The video tile's **mp** field (and **mp (downscale)** on a video asset in the Asset tab) now downsizes it when the clip is queued — the file is untouched and a smaller video is never upscaled. Video assets in the Asset tab also get an **in/out range** and **Video sound**. **Face Refine's Turbo** now offers the main Turbo section's choices (None / Turbo LoRA (Basic) / larryvrh / SLA) with its own LoRA and steps. 7+1 gains a stage-2 **Activation chunk rows** field. > > 🆕 **MiniMax H3에 7+1 하이레스 마무리가 추가되었습니다.** Turbo LoRA (Basic)에서 **7+1 hi-res finish**를 켜면 8스텝 중 7스텝을 작은 해상도(Start MP)로 돌리고, 비디오 latent를 업스케일한 뒤 **마지막 1스텝만 최종 해상도(Final MP)**에서 마무리합니다. 같은 8스텝보다 빠르게 큰 해상도를 얻습니다. 텍스트·First/Last·Reference(라이브러리 포함), Audio Lock, One-Take와 함께 쓸 수 있고, 켜면 Canvas MP는 잠기며 7+1로 만든 클립은 갤러리에서 **연핑크 테두리**로 표시됩니다. > > 🆕 **MiniMax H3 now has a 7+1 hi-res finish.** With Turbo LoRA (Basic), tick **7+1 hi-res finish**: 7 of the 8 steps run small (Start MP), the video latent is scaled up, and **only the last step runs at the final size (Final MP)**. You get a larger picture faster than a full-size 8-step run. It works with Text, First/Last, Reference (library too), Audio Lock and One-Take; Canvas MP is locked while it is on, and 7+1 clips get a **light-pink border** in the gallery. > > 🆕 **MiniMax H3에 Asset Library가 추가되었습니다.** 첫 번째 **Asset 탭**의 **+ Add ▾** 메뉴(Single Image / Images as a set / Video / Audio / From Gallery)로 이미지·영상·오디오·이미지 세트를 등록하고(From Gallery는 모든 갤러리·MusicMaker에서 가져오며 숨김·Cache·미리듣기를 지원), 카테고리·태그·구간 자르기, **프로젝트**(@별칭·순서)를 관리합니다. 참조 이미지는 노드 전체와 클립별 모두 **Files / Gallery** 또는 **Asset Library** 중 하나를 골라 쓰고, 프롬프트(메인 입력칸과 Prompt Edit 모두)에는 `@토큰`(자동완성 + Load 검사)을 쓰며 Prompt Write/Refine도 `@토큰`으로 작성합니다. ComfyUI-TJ_NODE의 Reference Asset Library가 필요합니다. > > 🆕 **MiniMax H3 now has an Asset Library.** The first **Asset tab**'s **+ Add ▾** menu (Single Image / Images as a set / Video / Audio / From Gallery) registers images, videos, audio and image sets (From Gallery imports from every gallery and MusicMaker, with hide, Cache and audio preview), with categories, tags, audio trim and **projects** (@aliases, order). References — node-wide and per clip — come from either **Files / Gallery** or **Asset Library**; prompts (main box and Prompt Edit) use `@tokens` (autocomplete + a Load check) and Prompt Write / Refine write with them. Needs ComfyUI-TJ_NODE's Reference Asset Library. > > 🆕 **모든 LLM 백엔드에 Connect Custom이 추가되었습니다.** MiniMax H3(Brief · Vision · LTX Upscale), 이미지 노드의 Prompt Enhance · Image → Prompt Write, MusicMaker에서 OpenAI 호환 서버(LM Studio · Ollama · llama.cpp · 게이트웨이)를 URL/모델/컨텍스트만 넣어 쓸 수 있습니다. 이미지 노드의 LLM 설정은 이제 **브라우저가 아니라 서버에 저장**되어 브라우저가 바뀌어도(웹 앱 포함) 같습니다. H3에는 **Prompt Refine → Include Images**, 갤러리 **Load more**(Settings → Output에서 개수 지정, 기본 50), 2-pass 업스케일이 추가되었습니다. > > 🆕 **Connect Custom is now a backend in every LLM picker.** MiniMax H3 (Brief · Vision · LTX Upscale), the image nodes' Prompt Enhance · Image → Prompt Write, and MusicMaker can use any OpenAI-compatible server (LM Studio · Ollama · llama.cpp · a gateway) with just a URL / model / context. The image nodes' LLM settings are now **stored on the server, not per browser**, so they match across browsers (and the web app). H3 gains **Prompt Refine → Include Images**, gallery **Load more** (page size set in Settings → Output, default 50) and a 2-pass upscale. > > 🆕 **MusicMaker 대규모 업데이트.** 세 번째 엔진 **YuE2**(Text to Music · Cover Music)가 추가되었고, **Melody Editor**(피아노롤)로 멜로디를 직접 그리거나 **실물 MIDI 건반**·컴퓨터 키보드로 녹음해 YuE2에 넘길 수 있습니다(샘플 음원 악기, MIDI 파일 가져오기/내보내기 포함). 트랙 ⋯ 메뉴에 **앨범 커버 복사 · 붙여넣기 · 업로드 · 갤러리에서 선택**이 생겨 시리즈 곡의 커버를 통일할 수 있고, 태그(제목·가사·커버 등)는 이제 저장된 파일 자체에 들어갑니다. 플레이리스트 ↻ 새로고침 버튼도 추가되었습니다. > > 🆕 **Big MusicMaker update.** A third engine, **YuE2** (Text to Music · Cover Music), and a **Melody Editor** piano roll where you draw a melody or record it from a **real MIDI keyboard** / the computer keyboard and hand it to YuE2 (with sample-based instruments and MIDI file import/export). The track ⋯ menu gains **album cover Copy · Paste · Upload · From Gallery** so a series can share one cover, and tags (title, lyrics, cover…) are now embedded in the saved file itself. A playlist ↻ refresh button was added too. > > 🆕 **ITDA ONE STUDIO (TJ)가 새롭게 추가되었습니다.** 영상·오디오 3-레인 스티치 타임라인 노드입니다(분할 · 그룹 · 스티치 · 스냅 · 웨이브폼 · Auto Stitch · 장면/비트 감지 · ffmpeg 내보내기). H3 영상 갤러리와 MusicMaker 플레이리스트에서 바로 미디어를 불러올 수 있습니다. > > 🆕 **ITDA ONE STUDIO (TJ) has been added.** A 3-lane video/audio stitch timeline node (split · group · stitch · snap · waveforms · Auto Stitch · scene/beat detect · ffmpeg export). Media can be imported straight from the H3 video gallery and the MusicMaker playlist. > > 🆕 **MiniMax H3에 Postprocess · Image Generator · Character Sheet가 추가되었습니다.** Postprocess는 Deblur → Denoise → Upscale → Skin Retouch → Add Grain → Interpolate → Resize를 한 번에 체인으로 처리하고, Image Generator는 T2I · Reference to Image 정지 이미지를, Character Sheet는 캐릭터 시트를 만듭니다(전용 H3 이미지 갤러리 포함). > > 🆕 **MiniMax H3 gains Postprocess · Image Generator · Character Sheet.** Postprocess chains Deblur → Denoise → Upscale → Skin Retouch → Add Grain → Interpolate → Resize in one pass, Image Generator makes T2I / Reference-to-Image stills, and Character Sheet makes character sheets (with a dedicated H3 image gallery). > > 🆕 **이미지 노드 Prompt Edit 통합.** Krea2 · Z-Image · Flux.2 Klein · Qwen 2511 · SDXL · Anima의 Prompt Edit이 한 화면으로 합쳐지고 LLM 백엔드가 세 가지(Local GGUF · ComfyUI native · OpenRouter)로 늘었으며, 프롬프트 헤더에 **Auto Enhance** 체크가 생겼습니다. > > 🆕 **Unified Prompt Edit on the image nodes.** Krea2 · Z-Image · Flux.2 Klein · Qwen 2511 · SDXL · Anima get one merged Prompt Edit screen with three LLM backends (Local GGUF · ComfyUI native · OpenRouter), plus an **Auto Enhance** checkbox in the prompt header. > > 🆕 **Qwen Image 2.1 ONE STUDIO가 새롭게 추가되었습니다.** Qwen Image 2.1 모델 계열을 위한 노드로, 2511의 UI/기능(T2I · I2I · Ref to Image · Edit · Inpaint/Outpaint · Upscale)을 그대로 따르면서 마스크 없는 인라인 드로잉 도구(펜/선/원/사각형, 단축키, 오른쪽 클릭 지우개)를 씁니다. **POSE** 모드도 새로 추가되어, VNCCS PoseStudio LoRA와 SAM3D Body를 사용해 한 이미지의 포즈를 다른 캐릭터에게 그대로 옮길 수 있습니다(비율 프리셋이 달린 크롭 도구 포함). > > 🆕 **Qwen Image 2.1 ONE STUDIO has been added.** A node for the Qwen Image 2.1 model family, following 2511's own UI/feature set (T2I · I2I · Ref to Image · Edit · Inpaint/Outpaint · Upscale) with a mask-free inline drawing tool (pen/line/circle/rect, keyboard shortcuts, right-click eraser). Also adds a new **POSE** mode that copies a pose from one image onto another character using the VNCCS PoseStudio LoRA and SAM3D Body (with an aspect-ratio-preset crop tool). > > 🆕 **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. > > 🆕 **MusicMaker ONE STUDIO가 새롭게 추가되었습니다.** 노드 하나에서 세 엔진 — **Ace-Step 1.5**(48 kHz, 3-스테이지 순차 샘플링, 기본값), **MiniMax Music 3**, **YuE2** — 으로 노래·연주곡을 생성합니다. SUNO식 2-패널 레이아웃(스타일·가사·보컬·BPM/키/박자 / 인라인 플레이어가 붙은 플레이리스트), H3식 **대기 큐**(카드별 취소), 태그가 박힌 파일 다운로드, Krea2 앨범 커버, 캡션·가사 LLM(로컬 GGUF / **OpenRouter** / ComfyUI TextGenerate). 노래/연주곡 토글, 저장 폴더 지정. > > 🆕 **MusicMaker ONE STUDIO has been added.** One node, three engines — **Ace-Step 1.5** (48 kHz, 3-stage progressive sampling, default), **MiniMax Music 3** and **YuE2** — for songs and instrumentals. SUNO-style two-pane layout (style · lyrics · vocals · BPM/key/time-sig, and a playlist with an inline player), an H3-style **generation queue** (per-card cancel), downloads of files with tags already embedded, Krea2 album covers, and a caption + lyrics LLM (Local GGUF / **OpenRouter** / ComfyUI TextGenerate). Song/Instrumental toggle, configurable save folder. > > 🆕 **이미지 노드 · MiniMax H3의 LLM에 OpenRouter 백엔드가 추가되었습니다.** Enhance / Image → Prompt 패널(Krea2 · Z-Image · Flux.2 Klein · Qwen 2511 · SDXL)과 MiniMax H3의 Image → Brief에서 로컬 GGUF 대신 OpenRouter 클라우드 모델을 선택할 수 있습니다. 키는 노드의 `.env` 하나에 저장되어 세 계열이 공유하며 Settings에서 마스킹 표시됩니다. > > 🆕 **OpenRouter LLM backend for the image nodes and MiniMax H3.** The Enhance / Image → Prompt panel (Krea2 · Z-Image · Flux.2 Klein · Qwen 2511 · SDXL) and MiniMax H3's Image → Brief can now use an OpenRouter cloud model instead of a local GGUF. One key in the node's `.env`, shared by all three, shown masked in Settings. > > 🆕 **갤러리 눈가리기.** 모든 노드 갤러리(+ MusicMaker 플레이리스트)의 각 썸네일에 👁 토글이 생겨 가릴 수 있고, 가린 목록은 서버에 한 곳으로 저장되어 노드와 AI ONE STUDIO 웹앱이 동기화됩니다. > > 🆕 **Per-thumbnail blur (눈가리기).** Every node gallery (and the MusicMaker playlist) gets a 👁 toggle on each thumbnail; the hidden list is stored server-side in one place and stays in sync between the nodes and the AI ONE STUDIO web app. > > 🧪 **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. [MusicMaker ONE STUDIO — 기능 상세 🧪](#musicmaker-one-studio--기능-상세-) 11. [MusicMaker ONE STUDIO — Feature Details 🧪](#musicmaker-one-studio--기능-상세-) 12. [ITDA ONE STUDIO — 기능 상세](#itda-one-studio--기능-상세) 12. [ITDA ONE STUDIO — Feature Details](#itda-one-studio--기능-상세) 13. [버그 수정 이력](#버그-수정-이력) 13. [Bug Fix History](#버그-수정-이력) 14. [라이선스](#라이선스) 14. [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**}| | **Qwen Image 2.1 ONE STUDIO (TJ)** 🆕 | Qwen Image 2.1 모델 계열
_{Qwen Image 2.1 model family}| T2I · I2I · Ref to Image(최대 10장) · Edit(최대 10장) · Inpaint · Outpaint · Upscale · **POSE(VNCCS PoseStudio LoRA)**
_{T2I · I2I · Ref to Image(up to 10 images) · Edit(up to 10 images) · Inpaint · Outpaint · Upscale · **POSE (VNCCS PoseStudio LoRA)**}| | **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 · **클립 릴레이 + 자동 합본** · 라이브 프리뷰 · **Postprocess** · **Image Generator** · **Character Sheet** *(실험적 / 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**}| | **MusicMaker ONE STUDIO (TJ)** 🆕🧪 | Ace-Step 1.5 · MiniMax Music 3 · YuE2 (음악 생성)
_{Ace-Step 1.5 / MiniMax Music 3 / YuE2 music model}| 노래 / 연주곡 · 3 엔진 · **Melody Editor(피아노롤 + MIDI 건반)** · **앨범 커버 복사/붙여넣기/업로드/갤러리** · **대기 큐** · 캡션·가사 LLM (로컬 / OpenRouter / TextGenerate / Connect Custom) · 태그가 박힌 파일
_{song / instrumental · 3 engines · **Melody Editor (piano roll + MIDI keyboard)** · **album cover copy / paste / upload / gallery** · **generation queue** · caption+lyric LLM (local / OpenRouter / TextGenerate / Connect Custom) · tags embedded in the file}| | **ITDA ONE STUDIO (TJ)** 🆕 | 영상·오디오 스티치 타임라인 (ffmpeg)
_{video / audio stitch timeline (ffmpeg)}| 3-레인 타임라인 · 분할 / 그룹 / 스티치 / 스냅 · 웨이브폼 · Auto Stitch · 장면/비트 감지 · 내보내기 · H3 영상 갤러리·MusicMaker 플레이리스트에서 불러오기
_{3-lane timeline · split / group / stitch / snap · waveforms · Auto Stitch · scene/beat detect · export · import from the H3 video gallery and MusicMaker playlist}| > **언어 지원**: 모든 노드의 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-FirstBlockCache](https://github.com/duckyshell/ComfyUI-MiniMaxH3-FirstBlockCache) 🧪 | 스텝 재사용 캐시
_{step-reuse cache}| 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/designloves2/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 | | [ComfyUI-FlashVSR_Ultra_Fast](https://github.com/lihaoyun6/ComfyUI-FlashVSR_Ultra_Fast) 🧪 | 타일 기반 디퓨전 VSR
_{tiled diffusion video super-resolution}| MiniMax H3 Upscale=FlashVSR VSR (좌측 패널 · 갤러리)
_{left panel + gallery}| | [ComfyUI-Fizgig-H3-Still](https://github.com/shootthesound/ComfyUI-Fizgig-H3-Still) 🧪 | 진짜 1프레임 H3 latent · 줄무늬 없는 디코드
_{true single-frame H3 latent + banding-free decode}| MiniMax H3 Image Generator Latent=Use Fizgig Latent
_{(선택 · optional)}| | [JK-AceStep-Nodes](https://github.com/jeankassio/JK-AceStep-Nodes) 🧪 | JKASS 품질 샘플러 (`jkass_quality`)
_{JKASS quality sampler}| MusicMaker Ace-Step 엔진
_{MusicMaker Ace-Step engine}| | [ComfyUI-Openrouter_node](https://github.com/gabe-init/ComfyUI-Openrouter_node) | OpenRouter LLM 키 저장소
_{OpenRouter LLM key store}| MusicMaker · 이미지 노드 · H3 의 OpenRouter LLM 백엔드 (선택)
_{optional — OpenRouter LLM backend for MusicMaker / image nodes / H3}| --- ## 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	Description
last_frame	IMAGE	—
video_path	STRING	—

LTX 2.5 ONE STUDIO (TJ)

Inputs (0)

Outputs (2)