EasyLoader (HunyuanDiT)(hunyuanDiTLoader)

설명

EasyLoader (HunyuanDiT)는 HunyuanDiT 기반 워크플로를 위한 편의성 로더입니다. 선택된 HunyuanDiT checkpoint와 VAE를 로드하고, 선택적으로 LoRA를 적용하며, 모델, 잠재 데이터 설정, 프롬프트 텍스트를 다운스트림 샘플링을 위한 PIPE_LINE으로 패키징합니다. 또한 로드된 MODEL과 VAE를 직접 노출하므로 EasyUse 파이프라인 노드 및 표준 ComfyUI 샘플러 워크플로에서 모두 유용합니다.

입력

• ckpt_name (콤보, 필수): 로드할 HunyuanDiT checkpoint입니다.
• vae_name (콤보, 필수): 잠재 데이터 디코딩에 사용할 VAE입니다.
• lora_name (콤보, 필수): 로드된 checkpoint에 적용할 LoRA입니다.
• lora_model_strength (실수, 필수, 기본값=1, 범위 -10 ~ 10): 모델 가중치에 적용되는 LoRA 강도입니다.
• lora_clip_strength (실수, 필수, 기본값=1, 범위 -10 ~ 10): 텍스트 인코더/CLIP 측에 적용되는 LoRA 강도입니다.
• resolution (콤보, 필수, 기본값 "1024 x 1024"): 생성된 잠재 데이터의 해상도 프리셋입니다.
• empty_latent_width (정수, 필수): 생성에 사용할 빈 잠재 데이터의 너비입니다.
• empty_latent_height (정수, 필수): 생성에 사용할 빈 잠재 데이터의 높이입니다.
• positive (문자열, 필수, 기본값 ""): 조건화를 구성하는 데 사용되는 포지티브 프롬프트 텍스트입니다.
• negative (문자열, 필수, 기본값 ""): 조건화를 구성하는 데 사용되는 네거티브 프롬프트 텍스트입니다. 비워 둘 수 있습니다.
• batch_size (정수, 필수, 기본값=1, 최소=1, 최대=64): 배치에서 생성할 잠재 데이터 수입니다.
• optional_lora_stack (LORA_STACK, 선택): 각 항목별 모델 및 CLIP 강도와 함께 적용할 추가 LoRA 스택입니다.
• optional_controlnet_stack (CONTROL_NET_STACK, 선택): 모델 파이프라인 구성 중 적용할 컨트롤넷 스택입니다.

출력

• PIPE_LINE: 다운스트림 EasyUse 노드를 위해 로드된 모델, VAE, 프롬프트 조건화 및 잠재 데이터 설정을 포함하는 EasyUse 파이프라인입니다.
• MODEL: LoRA 및 컨트롤넷 수정 이후의 로드된 HunyuanDiT 모델로, 샘플러에 사용할 준비가 된 상태입니다.
• VAE: 잠재 데이터를 이미지로 디코딩할 준비가 된 로드된 VAE입니다.

사용 참고 사항

• 이 노드는 올인원 HunyuanDiT 시작점으로 설계되었습니다. PIPE_LINE을 EasyUse 파이프라인 샘플러에 연결하거나, 표준 샘플러 워크플로에서 MODEL과 VAE를 직접 사용하세요.
• resolution 콤보는 일반적인 캔버스 크기를 선택하기 위한 편의 기능입니다. empty_latent_width와 empty_latent_height가 생성하려는 실제 픽셀 크기와 일치하는지 확인하세요.
• LoRA는 lora_name을 통해 별도의 모델 및 CLIP 강도와 함께 단일 LoRA로 제공하거나, optional_lora_stack을 통해 스택으로 제공하여 한 번에 여러 LoRA를 결합할 수 있습니다.
• 컨트롤넷 설정은 optional_controlnet_stack을 통해 제공됩니다. 개별 강도 및 전처리기 설정은 별도의 노드 입력이 아닌 스택 항목에 포함되어 전달됩니다.
• positive와 negative 문구는 PIPE_LINE 내부에 포함되어 전달되므로, 다운스트림 샘플러 노드는 별도의 조건화 로더 없이 이를 사용할 수 있습니다.
• 이 노드는 독립형 CLIP/텍스트 인코더 모델을 출력하지 않습니다. 조건화는 내부적으로 구성되어 PIPE_LINE 출력에 저장됩니다.