EasyLoader (PixArt)(pixArtLoader)

ComfyUI-Easy-Use 패키지의 EasyLoader (PixArt) 노드(pixArtLoader)는 PixArt 모델을 위한 편의 로더입니다. 이 노드는 PixArt에 필요한 모든 구성 요소, 즉 확산 모델(체크포인트 또는 단독 모델 파일에서), VAE, CLIP 텍스트 인코더, SD3 스타일 T5 텍스트 인코더를 로드한 다음, positive 및 negative 텍스트 필드에서 프롬프트 조건화를 구성하고, 요청된 크기와 배치 크기로 빈 잠재 데이터를 생성하고, LoRA 수정을 적용한 다음, 모든 것을 Easy-Use 파이프라인으로 패키징합니다.

설명

이 노드는 PixArt 워크플로를 위한 원스톱 로더로 설계되었습니다. 별도의 체크포인트, VAE, CLIP, T5, LoRA, 빈 잠재 데이터 노드를 연결하는 대신 EasyLoader (PixArt)를 사용하여 샘플링을 위한 완전한 PIPE_LINE을 준비할 수 있습니다. 또한 원시 MODEL 및 VAE 출력도 노출하므로 다른 곳에 연결해야 하는 경우 사용할 수 있습니다.

이 노드는 사전 계산된 조건화가 아닌 원시 텍스트 프롬프트를 입력으로 받습니다. positive 및 negative 문자열은 선택된 CLIP 및 T5 인코더를 사용하여 내부적으로 인코딩됩니다.

입력

필수 입력

• ckpt_name (COMBO): PixArt 가중치가 포함된 체크포인트 파일을 선택합니다. 설치된 모델 파일과 일치하는 체크포인트를 선택하세요.
• model_name (COMBO): 단독 PixArt 확산 모델 파일을 선택합니다. PixArt 가중치가 저장된 방식에 따라 이 옵션 또는 ckpt_name을 사용하세요.
• vae_name (COMBO): 잠재 데이터를 이미지로 디코딩하는 데 사용되는 VAE를 선택합니다.
• t5_type (COMBO): PixArt 조건화의 T5 부분에 사용되는 텍스트 인코더 유형입니다. 현재 사용 가능한 유일한 옵션은 sd3입니다. PixArt는 SD3 스타일 T5 텍스트 인코더에 의존합니다.
• clip_name (COMBO): 조건화를 위해 T5와 함께 사용되는 CLIP 텍스트 인코더를 선택합니다.
• padding (INT, 기본값 1, 범위 1–300): T5/SD3 텍스트 인코더로 텍스트를 인코딩할 때 사용되는 패딩 길이를 설정합니다. 값이 높을수록 프롬프트 주위에 패딩 토큰이 추가됩니다.
• t5_name (COMBO): 텍스트 인코딩에 사용되는 T5 모델 파일을 선택합니다.
• device (COMBO, 기본값 cpu): 로드된 구성 요소가 실행되는 위치를 결정합니다. 옵션:
  • auto: ComfyUI가 장치를 자동으로 선택하도록 합니다.
  • cpu: CPU 실행을 강제합니다.
  • gpu: GPU 실행을 강제합니다.
• dtype (COMBO): 로드된 모델에 사용되는 정밀도를 제어합니다. 옵션:
  • default: 모델의 기본 정밀도를 사용합니다.
  • auto (comfy): ComfyUI가 적절한 정밀도를 결정하도록 합니다.
  • FP32: 전체 float32 정밀도.
  • FP16: 절반 정밀도. VRAM 사용량을 줄이는 데 유용합니다.
  • BF16: bfloat16 정밀도. 지원되는 하드웨어에서 유용합니다.
• lora_name (COMBO): PixArt 모델에 적용할 단일 LoRA 파일을 선택합니다.
• lora_model_strength (FLOAT, 기본값 1, 범위 -10~10, 단계 0.01): 선택된 LoRA가 모델에 영향을 미치는 강도를 제어합니다. 음수 값이 허용됩니다.
• ratio (COMBO, 기본값 "1.00"): 이름으로 종횡비 사전 설정을 선택합니다. 기본값 "1.00"은 정사각형 1:1 종횡비에 해당합니다.
• empty_latent_width (INT): 생성된 빈 잠재 데이터의 픽셀 단위 너비입니다. 기본값이 설정되어 있지 않으므로 원하는 너비를 지정하세요.
• empty_latent_height (INT): 생성된 빈 잠재 데이터의 픽셀 단위 높이입니다. 기본값이 설정되어 있지 않으므로 원하는 높이를 지정하세요.
• positive (STRING, 기본값 ""): 조건화에 사용되는 포지티브 텍스트 프롬프트입니다.
• negative (STRING, 기본값 ""): 조건화에 사용되는 네거티브 텍스트 프롬프트입니다.
• batch_size (INT, 기본값 1, 범위 1–64): 빈 잠재 데이터 배치에 생성할 샘플 수입니다.

선택적 입력

• optional_lora_stack (LORA_STACK): 적용할 추가 LoRA 스택입니다. 모델에 둘 이상의 LoRA를 적용해야 하거나 다른 Easy-Use 노드의 LoRA 스택을 사용할 때 유용합니다.

출력

• PIPE_LINE: 로드된 모델, VAE, 조건화, 잠재 데이터 및 후속 Easy-Use 샘플러 노드에 필요한 기타 설정이 포함된 Easy-Use 파이프라인 객체입니다.
• MODEL: LoRA 변경 사항이 적용된 로드된 PixArt 확산 모델입니다.
• VAE: 로드된 VAE로, 디코더 또는 샘플러 노드에 직접 연결할 수 있습니다.

사용 참고 사항

• 이 노드는 별도의 CONDITIONING 출력을 노출하지 않습니다. 조건화는 positive 및 negative에서 내부적으로 구성되어 PIPE_LINE에 포함됩니다.
• ckpt_name 대신 model_name을 사용하여 모델을 로드하는 경우 VAE, CLIP 및 T5 선택이 모델의 요구 사항과 일치하는지 확인하세요.
• PixArt는 SD3 스타일 T5 텍스트 인코더를 사용하므로 t5_type은 현재 sd3로 고정되어 있습니다.
• padding 값은 T5 텍스트 인코딩 중에 적용됩니다. 긴 프롬프트로 작업하는 경우 프롬프트 토큰이 잘리거나 정렬이 어긋나지 않도록 값을 늘려야 할 수 있습니다.
• device는 기본적으로 cpu입니다. 하드웨어가 더 빠른 T5/CLIP 인코딩을 지원하는 경우 gpu 또는 auto로 전환하세요.
• ratio는 편의를 위한 종횡비 사전 설정입니다. 실제 출력 잠재 데이터 해상도는 empty_latent_width 및 empty_latent_height로 제어됩니다.
• 여러 LoRA를 적용할 때는 optional_lora_stack을 사용하세요. LoRA 강도 값은 효과를 반전하거나 줄이기 위해 음수일 수 있습니다.