모델 미리보기 재정의(ModelPreviewOverrideKJ)

모델 미리보기 재정의 노드(클래스 ModelPreviewOverrideKJ)는 ComfyUI의 기본 샘플러 미리보기 512px 제한을 우회하여 노드 자체에 전용 실시간 미리보기 프레임을 추가합니다. 이는 픽셀 공간 모델(Chroma Radiance, ZImage, HiDream-O1 등)이 중간 결과를 전체 샘플러 해상도로 보는 데 유용합니다. 또한 비디오 모델의 애니메이션 WebP 미리보기를 지원하며, 필요 시 표준 샘플러 노드 미리보기 오버레이를 숨겨 워크플로를 더 깔끔하게 만들 수 있습니다.

입력

model (MODEL, 필수)

미리보기 재정의를 적용할 모델입니다. 샘플링의 각 단계마다 이 노드에 실시간 미리보기가 생성됩니다.

max_resolution (INT, 기본값 1024, 범위 0–8192, step 8)

실시간 미리보기 위젯의 최대 가로/세로 길이(픽셀)입니다.

• 0 – 다운스케일 없음; 미리보기가 전체 샘플러 해상도로 렌더링됩니다(매우 높은 해상도에서는 주의).
• 양수 값 – 미리보기의 긴 쪽이 이 크기로 제한되고, 다른 쪽은 비율에 맞게 조정됩니다.

jpeg_quality (INT, 기본값 80, 범위 30–100, step 1)

미리보기 이미지를 DOM 위젯으로 전송하기 위해 압축할 때 사용되는 JPEG 품질입니다. 높은 값은 더 나은 품질을 제공하지만 페이로드가 커지고, 낮은 값은 오버헤드를 줄이되 눈에 띄는 압축 아티팩트가 발생합니다.

suppress_default_preview (BOOLEAN, 기본값 true)

활성화하면 샘플링 중에 표준 샘플러 노드 미리보기 오버레이가 숨겨져 이 노드의 프레임만 업데이트됩니다. 진행 막대는 정상적으로 계속 진행됩니다. 비활성화하면 노드의 실시간 프레임과 함께 기본 ComfyUI 미리보기도 계속 표시됩니다.

preview_frames (INT, 기본값 1, 범위 1–1024, step 1)

애니메이션 미리보기를 위해 각 비디오 단계의 잠재 데이터에서 샘플링할 프레임 수입니다.

• 1 – 단일 프레임(현재 동작, 가장 빠름).
• 2 ~ 1024 – 샘플링된 프레임에서 애니메이션 WebP를 생성하며, preview_fps에서 설정한 FPS로 재생됩니다.
  이 입력은 비디오 모델(5D 잠재 데이터)에만 유효하며, 이미지 모델에서는 무시됩니다.

preview_fps (INT, 기본값 12, 범위 1–60, step 1)

애니메이션 WebP 미리보기의 재생 프레임 속도입니다. preview_frames가 1이면 무시됩니다.

vae (VAE, 선택 사항)

잠재 데이터를 실제 RGB 미리보기로 디코딩하기 위한 선택적 VAE입니다.

• TAEHV-LTX – 빠르고 작은 디코딩 사용(VAE가 GPU에 고정됨).
• 다른 LTX VAE – vae.decode()를 통해 전체 품질 디코딩을 수행하며, 단계당 상당히 느립니다.
  제공되지 않으면 노드는 모델의 기본 VAE(사용 가능한 경우) 또는 표준 디코딩 방법으로 대체됩니다.

출력

MODEL

model 입력에 전달된 것과 동일한 모델로, 변경되지 않습니다. 이 노드는 미리보기 기능을 추가하면서 모델이나 출력을 수정하지 않는 패스스루(pass-through) 역할을 합니다.

사용 참고 사항

• 실시간 미리보기 프레임은 노드에 자체 포함된 위젯으로 나타나므로, 샘플러 노드의 미리보기가 숨겨져 있거나 suppress_default_preview가 활성화된 경우에도 계속 표시됩니다.
• 비디오 모델의 경우 preview_frames를 1보다 큰 값으로 설정하면 샘플링 중 애니메이션 미리보기를 볼 수 있습니다. 단계당 여러 프레임을 추출하면 메모리와 계산 오버헤드가 증가한다는 점을 유의하세요.
• 선택적 VAE를 사용할 때 속도와 품질 간의 균형은 VAE 유형에 따라 결정됩니다: TAEHV-LTX는 속도를 우선시하고, 다른 LTX VAE는 충실도를 우선시합니다.