Model Memory Usage Factor Override (ModelMemoryUsageFactorOverride) - ComfyUI-KJNodes

Model Memory Usage Factor Override 노드는 입력 모델을 복제하고 래퍼(Wrapper)를 추가하여 기능을 구현합니다.

Model Memory Usage Factor Override 노드는 샘플링 과정에서 모델의 메모리 사용 계수를 동적으로 조정하기 위한 실험적 도구입니다. 핵심 기능은 모델의 기존 메모리 사용 전략을 재정의하여, 사용자가 하드웨어 조건이나 성능 요구에 따라 미세 조정할 수 있도록 하여 VRAM 사용량을 최적화하는 것입니다.

노드 기능

이 노드는 입력 모델을 복제하고 래퍼(Wrapper)를 추가하여 기능을 구현합니다. 이 래퍼는 샘플링 준비 단계(PREPARE_SAMPLING)에 개입하여 사용자가 지정한 memory_usage_factor 값을 모델에 적용하여, 모델 내부의 기본 메모리 사용 계수를 재정의합니다. 내부 구현은 모델의 순전파 과정(예: wan_ffn_chunked_forward 메서드)에 대한 잠재적 조정을 포함하여, 계산 시 텐서의 청킹 전략을 제어함으로써 VRAM 피크 사용량에 영향을 미칩니다.

노드 파라미터 설명 - Model Memory Usage Factor Override

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`model`	MODEL	예	-	-	**: 메모리 사용 계수를 조정할 기본 모델입니다. 이 파라미터는 표준 MODEL 타입 데이터 스트림을 받습니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`memory_usage_factor`	FLOAT	예	1.0	0.0 - 100.0 (스텝: 0.001)	**: 모델의 원래 메모리 사용 계수를 재정의하는 데 사용되는 승수입니다. 범위는 0.0부터 100.0까지이며, 조정 스텝은 0.001입니다. 기본값 1.0은 원래 상태를 유지함을 의미합니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
MODEL	MODEL	**: 입력된 계수에 따라 메모리 사용 동작이 조정된 새로운 모델 인스턴스를 출력합니다.

사용 시나리오

고해상도 이미지나 복잡한 모델을 처리하다가 VRAM 부족(Out of Memory) 오류가 발생할 경우, 이 노드를 모델 로드(Load Checkpoint)와 샘플러(KSampler) 사이에 삽입할 수 있습니다. memory_usage_factor 값을 적절히 낮추면(예: 0.8로 설정) 단일 계산에 필요한 VRAM을 줄여, 제한된 GPU 메모리에서도 생성 작업을 완료할 수 있습니다.

주의사항

이 노드는 실험적(EXPERIMENTAL)으로 표시되어 있으며, 그 동작과 효과는 모델 아키텍처나 ComfyUI 버전에 따라 다를 수 있습니다. 메모리 사용 계수를 조정하면 생성 속도에 영향을 미칠 수 있으며, 극단적인 값의 경우 이미지 품질 저하나 계산 오류를 초래할 수 있으므로, 조정 후 효과를 검증하는 것이 좋습니다.

Model Memory Usage Factor Override 노드 소스 코드 링크

Model Memory Usage Factor Override 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Model Memory Usage Factor Override(ModelMemoryUsageFactorOverride)