EasyLoader (PixArt): загрузчик PixArt для ComfyUI-Easy-Use(pixArtLoader)

Нода EasyLoader (PixArt) (pixArtLoader) представляет собой удобный загрузчик для моделей PixArt в пакете ComfyUI-Easy-Use. Она загружает все необходимые для PixArt компоненты: диффузионную модель (из checkpoint или отдельного файла модели), VAE, текстовый энкодер CLIP и текстовый энкодер T5 в стиле SD3. Затем формирует условие из текстовых полей positive и negative, создает пустые латентные представления с указанными размерами и размером пакета, применяет модификации LoRA и упаковывает результат в pipeline Easy-Use.

Описание

Этот узел задуман как универсальный загрузчик для рабочих процессов PixArt. Вместо того чтобы выстраивать цепочку из отдельных нод checkpoint, VAE, CLIP, T5, LoRA и пустых латентных представлений, вы можете использовать EasyLoader (PixArt) для подготовки полного PIPE_LINE к сэмплированию. Он также предоставляет сырые выходы MODEL и VAE, если вам нужно подключить их в другое место.

Узел ожидает необработанные текстовые запросы, а не заранее вычисленное условие. Строки positive и negative кодируются внутренне с помощью выбранных энкодеров CLIP и T5.

Входы

Обязательные входы

• ckpt_name (COMBO): Выбирает файл checkpoint с весами PixArt. Выберите checkpoint, соответствующий вашим установленным файлам моделей.
• model_name (COMBO): Выбирает отдельный файл диффузионной модели PixArt. Используйте либо его, либо ckpt_name, в зависимости от того, как хранятся веса PixArt.
• vae_name (COMBO): Выбирает VAE, используемый для декодирования латентных представлений в изображения.
• t5_type (COMBO): Тип текстового энкодера, используемый для части T5 в условии PixArt. В настоящее время доступен только вариант sd3; PixArt полагается на текстовый энкодер T5 в стиле SD3.
• clip_name (COMBO): Выбирает текстовый энкодер CLIP, используемый вместе с T5 для формирования условия.
• 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): Выбирает один файл LoRA для применения к модели PixArt.
• 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 к модели, или при использовании стека LoRA из другой ноды Easy-Use.

Выходы

• PIPE_LINE: Объект pipeline Easy-Use, содержащий загруженную модель, VAE, условие, латентные представления и другие настройки, необходимые последующим нодам сэмплеров Easy-Use.
• MODEL: Загруженная диффузионная модель PixArt с примененными изменениями LoRA.
• VAE: Загруженный VAE, доступный для прямого подключения к нодам декодера или сэмплера.

Примечания по использованию

• Узел не предоставляет отдельного выхода CONDITIONING. Условие формируется внутренне из positive и negative и включается в PIPE_LINE.
• Если вы загружаете модель через model_name вместо ckpt_name, убедитесь, что выбранные VAE, CLIP и T5 соответствуют требованиям модели.
• PixArt использует текстовый энкодер T5 в стиле SD3, поэтому t5_type в настоящее время зафиксирован как sd3.
• Значение padding применяется при кодировании текста T5. Если вы работаете с длинными запросами, возможно, потребуется увеличить его, чтобы избежать обрезания или смещения токенов запроса.
• device по умолчанию равен cpu; переключитесь на gpu или auto, если ваше оборудование поддерживает более быстрое кодирование T5/CLIP.
• ratio это удобный пресет соотношения сторон. Фактическое разрешение выходного латентного представления задается параметрами empty_latent_width и empty_latent_height.
• Используйте optional_lora_stack при применении нескольких LoRA; значения силы LoRA могут быть отрицательными для инвертирования или уменьшения эффекта.