Remplacement de l'Aperçu du Modèle(ModelPreviewOverrideKJ)

Le nœud Remplacement de l'Aperçu du Modèle (classe ModelPreviewOverrideKJ) ajoute un cadre d'aperçu en direct dédié directement sur le nœud, contournant la limite par défaut de 512 px de ComfyUI sur les aperçus d'échantillonnage. Ceci est particulièrement utile pour les modèles pixel‑space (Chroma Radiance, ZImage, HiDream‑O1, …) qui bénéficient de la visualisation des résultats intermédiaires à la résolution de l'échantillonneur complète. Le nœud prend également en charge les aperçus WebP animés pour les modèles vidéo et peut éventuellement supprimer la superposition d'aperçu standard du nœud d'échantillonnage pour un flux de travail plus propre.

Entrées

model (MODEL, requis)

Le modèle auquel attacher le remplacement d'aperçu. Chaque étape de l'échantillonnage produira un aperçu en direct sur ce nœud.

max_resolution (ENTIER, défaut 1024, plage 0–8192, pas 8)

Longueur de côté maximale (en pixels) pour le widget d'aperçu en direct.

• 0 – aucune réduction ; l'aperçu est rendu à la résolution complète de l'échantillonneur (à utiliser avec prudence pour les très hautes résolutions).
• Toute valeur positive – le bord le plus long de l'aperçu est limité à cette taille ; l'autre bord est mis à l'échelle proportionnellement.

jpeg_quality (ENTIER, défaut 80, plage 30–100, pas 1)

Qualité JPEG utilisée lors de la compression de l'aperçu pour le transport vers le widget DOM. Des valeurs plus élevées donnent une meilleure qualité mais des charges utiles plus volumineuses ; des valeurs plus faibles réduisent la surcharge au prix d'artefacts de compression visibles.

suppress_default_preview (BOOLÉEN, défaut vrai)

Lorsqu'elle est activée, la superposition d'aperçu standard du nœud d'échantillonnage est masquée pendant l'échantillonnage, de sorte que seul le cadre de ce nœud se met à jour. La barre de progression continue normalement. Désactivez-la si vous souhaitez toujours voir l'aperçu par défaut de ComfyUI à côté du cadre en direct du nœud.

preview_frames (ENTIER, défaut 1, plage 1–1024, pas 1)

Nombre d'images à échantillonner à partir du latent de chaque étape vidéo pour un aperçu animé.

• 1 – image unique (comportement actuel, le plus rapide).
• 2 à 1024 – produit un WebP animé à partir des images échantillonnées, lu à la fréquence d'images définie par preview_fps.
  Cette entrée est uniquement efficace pour les modèles vidéo (latents 5D) ; elle est ignorée pour les modèles d'image.

preview_fps (ENTIER, défaut 12, plage 1–60, pas 1)

Fréquence d'images de lecture pour l'aperçu WebP animé. Ignoré lorsque preview_frames est 1.

vae (VAE, optionnel)

VAE optionnel pour décoder les latents en aperçus RVB réels.

• TAEHV-LTX – utilise un décodage rapide et minuscule (le VAE est épinglé au GPU).
• Tout autre VAE LTX – effectue un décodage de pleine qualité via vae.decode(), ce qui est significativement plus lent par étape.
  S'il n'est pas fourni, le nœud revient au VAE par défaut du modèle (si disponible) ou à une méthode de décodage standard.

Sorties

MODEL

Le même modèle passé dans l’entrée model, inchangé. Ce nœud est un pass-through qui ajoute des fonctionnalités d'aperçu sans modifier le modèle ni ses sorties.

Notes d'utilisation

• Le cadre d'aperçu en direct apparaît comme un widget autonome sur le nœud, il reste donc visible même lorsque l'aperçu du nœud d'échantillonnage est masqué ou lorsque suppress_default_preview est activé.
• Pour les modèles vidéo, définissez preview_frames sur une valeur supérieure à 1 pour voir un aperçu animé pendant l'échantillonnage. Gardez à l'esprit que l'extraction de plusieurs images par étape augmente la surcharge de mémoire et de calcul.
• Lorsque vous utilisez un VAE optionnel, le compromis entre vitesse et qualité est contrôlé par le type de VAE : TAEHV-LTX privilégie la vitesse ; les autres VAE LTX privilégient la fidélité.