Переопределение предварительного просмотра модели(ModelPreviewOverrideKJ)

Нода Model Preview Override (класс ModelPreviewOverrideKJ) добавляет выделенный кадр живого предпросмотра непосредственно на ноду, обходя стандартное ограничение ComfyUI в 512 пикселей для предпросмотра сэмплера. Это особенно полезно для моделей, работающих в пиксельном пространстве (Chroma Radiance, ZImage, HiDream-O1, …), которым полезно видеть промежуточные результаты при полном разрешении сэмплера. Нода также поддерживает анимированные WebP-предпросмотры для видеомоделей и может опционально подавлять стандартный оверлей предпросмотра ноды сэмплера для более чистого рабочего процесса.

Входы

model (MODEL, обязательно)

Модель, к которой прикрепляется переопределение предпросмотра. Каждый шаг во время выборки будет создавать живой предпросмотр на этой ноде.

max_resolution (INT, по умолчанию 1024, диапазон 0–8192, шаг 8)

Максимальная длина стороны (в пикселях) для виджета живого предпросмотра.

• 0 – без уменьшения; предпросмотр отображается при полном разрешении сэмплера (используйте с осторожностью при очень высоких разрешениях).
• Любое положительное значение – большая сторона предпросмотра прижимается к этому размеру; другая сторона масштабируется пропорционально.

jpeg_quality (INT, по умолчанию 80, диапазон 30–100, шаг 1)

Качество JPEG при сжатии изображения предпросмотра для передачи в DOM-виджет. Более высокие значения дают лучшее качество, но больший размер полезной нагрузки; меньшие значения снижают накладные расходы за счёт видимых артефактов сжатия.

suppress_default_preview (BOOLEAN, по умолчанию истина)

При включении стандартный оверлей предпросмотра ноды сэмплера скрывается во время выборки, так что обновляется только кадр этой ноды. Индикатор прогресса продолжает нормально работать. Отключите, если вы всё ещё хотите видеть стандартный предпросмотр ComfyUI рядом с живым кадром ноды.

preview_frames (INT, по умолчанию 1, диапазон 1–1024, шаг 1)

Количество кадров, извлекаемых из латентного представления каждого видешага для анимированного предпросмотра.

• 1 – одиночный кадр (текущее поведение, быстрее всего).
• от 2 до 1024 – создаёт анимированный WebP из извлечённых кадров, воспроизводимый с частотой кадров, заданной preview_fps.
  Этот вход эффективен только для видеомоделей (5D латентные представления); для моделей изображений он игнорируется.

preview_fps (INT, по умолчанию 12, диапазон 1–60, шаг 1)

Частота кадров воспроизведения для анимированного WebP-предпросмотра. Игнорируется, если preview_frames равно 1.

vae (VAE, необязательно)

Опциональный VAE для декодирования латентных представлений в настоящие RGB-предпросмотры.

• TAEHV-LTX – использует быстрое, крошечное декодирование (VAE закрепляется на GPU).
• Любой другой LTX VAE – выполняет декодирование полного качества через vae.decode(), что значительно медленнее на каждом шаге.
  Если не указан, нода возвращается к VAE модели по умолчанию (если доступен) или к стандартному методу декодирования.

Выходы

MODEL

Та же модель, что была передана во вход model, без изменений. Эта нода является сквозной – она добавляет функциональность предпросмотра, не изменяя модель и её выходы.

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

• Кадр живого предпросмотра отображается как самодостаточный виджет на ноде, поэтому он остаётся видимым, даже когда предпросмотр ноды сэмплера скрыт или когда включён suppress_default_preview.
• Для видеомоделей установите preview_frames на значение больше 1, чтобы видеть анимированный предпросмотр во время выборки. Имейте в виду, что извлечение нескольких кадров на каждом шаге увеличивает нагрузку на память и вычисления.
• При использовании опционального VAE компромисс между скоростью и качеством контролируется типом VAE: TAEHV-LTX ставит скорость на первое место; другие LTX VAE ставят на первое место точность.