EasyLoader (Kolors) 노드: ComfyUI-Easy-Use(kolorsLoader)

EasyLoader (Kolors) 노드(kolorsLoader)는 UNet, VAE, ChatGLM3 텍스트 인코더, 선택적 LoRA를 포함한 완전한 Kolors 추론 파이프라인을 한 번에 로드합니다. 이 노드는 EasyUse/Loaders 카테고리에 속합니다. 준비된 MODEL과 VAE를 반환할 뿐만 아니라, 하위 EasyUse 노드가 직접 사용할 수 있는 PIPE_LINE도 구성합니다.

설명

Kolors는 표준 CLIP 기반 인코더 대신 ChatGLM3를 텍스트 인코더로 사용하는 텍스트 기반 이미지 생성 모델 제품군입니다. 이 로더는 해당 아키텍처에 맞게 설계되었습니다. 필수 모델 구성 요소를 로드하고 단일 노드에서 EasyUse pipeline, 모델, VAE를 구성합니다. 프롬프트 인코딩에는 ChatGLM3가 필요하므로 chatglm3_name 위젯은 필수 항목입니다.

입력

필수

• unet_name (콤보): 로드할 Kolors UNet 파일을 선택합니다.
• vae_name (콤보): 잠재 데이터 디코딩에 사용할 VAE 파일을 선택합니다.
• chatglm3_name (콤보): positive와 negative를 인코딩하는 데 사용할 ChatGLM3 텍스트 인코더 파일을 선택합니다.
• lora_name (콤보): 적용할 LoRA를 선택합니다. 사용 가능한 옵션은 ComfyUI에서 인식하는 LoRA 파일입니다.
• lora_model_strength (실수, 기본값=1, 최소=-10, 최대=10, 단계=0.01): diffusion 모델 가중치에 적용되는 LoRA 강도입니다. 0은 모델 측 LoRA 효과를 비활성화하고, 음수 값은 반전시킵니다.
• lora_clip_strength (실수, 기본값=1, 최소=-10, 최대=10, 단계=0.01): ChatGLM3 텍스트 인코더 가중치에 적용되는 LoRA 강도입니다. 0은 텍스트 인코더 측 LoRA 효과를 비활성화하고, 음수 값은 반전시킵니다.
• resolution (콤보, 기본값="1024 x 576"): empty_latent_width와 empty_latent_height를 표준 값으로 설정하는 간편 사전 설정입니다. 사전 설정을 선택한 후에도 사용자 지정 크기를 수동으로 입력할 수 있습니다.
• empty_latent_width (정수): 생성할 빈 잠재 데이터의 너비입니다. 일반적으로 resolution 콤보로 설정되지만, 사용자 지정 크기로 재정의할 수 있습니다.
• empty_latent_height (정수): 생성할 빈 잠재 데이터의 높이입니다. 일반적으로 resolution 콤보로 설정되지만, 사용자 지정 크기로 재정의할 수 있습니다.
• positive (문자열, 기본값=""): 포지티브 프롬프트 텍스트입니다. 선택된 ChatGLM3 텍스트 인코더를 사용하여 인코딩됩니다.
• negative (문자열, 기본값=""): 네거티브 프롬프트 텍스트입니다. 선택된 ChatGLM3 텍스트 인코더를 사용하여 인코딩됩니다.
• batch_size (정수, 기본값=1, 최소=1, 최대=64): pipeline에서 생성할 잠재 데이터의 수입니다. 값이 높을수록 더 많은 VRAM을 사용합니다.

선택 사항

• model_override (MODEL): 연결되면 unet_name에서 UNet을 로드하는 대신 이 모델을 사용합니다.
• vae_override (VAE): 연결되면 vae_name에서 VAE를 로드하는 대신 이 VAE를 사용합니다.
• optional_lora_stack (LORA_STACK): 기본 lora_name 선택과 함께 여러 LoRA를 적용하려면 여기에 LoRA 스택을 연결합니다.
• auto_clean_gpu (논리값, 기본값=거짓): 로드 후 자동 GPU 정리를 시도하려면 활성화합니다. 모델을 자주 전환할 때 VRAM 압력을 줄일 수 있습니다. 로드된 모델을 반복 샘플링을 위해 메모리에 캐시된 상태로 유지하려면 비활성화합니다.

출력

• PIPE_LINE: 로드된 모델, VAE, 프롬프트, 잠재 데이터 너비/높이, 배치 크기를 포함하는 EasyUse pipeline 객체입니다. 샘플링을 위해 pipeline을 입력으로 받는 EasyUse 노드에 연결합니다.
• MODEL: 선택된 LoRA / LoRA 스택 / 모델 재정의를 로드하고 적용한 후의 유효 모델입니다. 표준 ComfyUI 샘플링 노드와 함께 사용합니다.
• VAE: VAE를 로드하고 VAE 재정의를 적용한 후의 유효 VAE입니다. 잠재 데이터를 이미지로 디코딩하는 데 사용합니다.

사용 참고 사항

• Kolors는 일반적인 CLIP 텍스트 인코더 대신 ChatGLM3를 사용합니다. 프롬프트 인코더를 변경하려면 chatglm3_name을 사용합니다.
• resolution 메뉴는 empty_latent_width와 empty_latent_height를 설정하기 위한 편의 기능입니다. 사전 설정을 선택하면 해당 필드가 덮어써지므로, 다른 종횡비가 필요하면 이후에 사용자 지정 값을 입력하세요. 크기는 잠재 데이터 형식과 호환되도록 유지하세요. 일반적으로 8 또는 16의 배수가 필요합니다.
• LoRA 강도는 서로 독립적입니다. lora_model_strength는 diffusion 모델 가중치에 영향을 미치고, lora_clip_strength는 ChatGLM3 텍스트 인코더 가중치에 영향을 미칩니다. 0 값은 해당 LoRA 측을 비활성화하며, 위젯은 음수 값도 허용합니다.
• 여러 LoRA가 필요하면 optional_lora_stack을 연결합니다. 기본 lora_name LoRA는 해당 강도가 0으로 설정되거나 no-op 항목이 선택되지 않는 한 계속 적용됩니다.
• 그래프의 다른 곳에서 이미 모델 또는 VAE를 로드한 경우 model_override와 vae_override를 사용하세요. 이렇게 하면 동일한 파일을 디스크에서 다시 로드하지 않아도 되고, 여러 로더 구성에서 리소스를 재사용할 수 있습니다.