Décoder et enregistrer la vidéo(DecodeAndSaveVideo)

Description

Le nœud Décoder et enregistrer la vidéo décode les images vidéo et l'audio facultatif à partir de représentations latentes, les combine et enregistre la vidéo résultante directement dans un fichier. Il est conçu pour l'efficacité mémoire : les images décodées sont écrites sur le disque à la volée sans stocker toutes les images intermédiaires en RAM. Cela le rend adapté aux vidéos longues ou haute résolution qui dépasseraient autrement la mémoire disponible.

Le nœud attend une représentation latente des images vidéo (généralement produite par un modèle de diffusion vidéo) et une représentation latente facultative pour l'audio. Deux modèles VAE distincts doivent être fournis : un pour décoder le latent vidéo (video_vae) et un pour décoder le latent audio (audio_vae – requis seulement si un audio_latent est fourni). Le nœud prend également en charge le décodage en mosaïque (spatial et temporel) pour réduire davantage l'utilisation de la mémoire, configurable via les paramètres de mosaïque.

Utilisez ce nœud comme étape finale dans un pipeline de génération vidéo pour exporter le résultat vers un format de conteneur vidéo courant.

Entrées

Comportement de la mosaïque

• Lorsque la mosaïque est désactivée, l'image entière est décodée en une seule fois – cela utilise le plus de mémoire.
• La mosaïque spatiale (tiling = "spatial" ou "both") divise chaque image en tuiles plus petites de taille tile_size×tile_size, les décode indépendamment et mélange les régions qui se chevauchent.
• La mosaïque temporelle (tiling = "temporal" ou "both") divise la séquence d'images en blocs de temporal_size images, chaque bloc se chevauchant de temporal_overlap images. Applicable uniquement pour les VAE qui prennent en charge la décomposition temporelle (par ex., certains VAE vidéo).
• Le nœud gère automatiquement le mélange des régions qui se chevauchent et des bords des tuiles.

Sorties

Ce nœud n'a aucune connexion de sortie. La vidéo décodée est écrite directement sur le disque en utilisant le chemin construit à partir de filename_prefix. Le nœud ne renvoie aucune donnée au flux de travail.

Notes d'utilisation

• Gestion de la mémoire : Le nœud diffuse les images décodées vers le disque au fur et à mesure de leur production. Même avec la mosaïque désactivée, il n'accumule pas toutes les images en mémoire simultanément. La mosaïque réduit encore la mémoire de pointe au prix d'un décodage plus lent.
• Audio : Pour inclure l'audio, fournissez à la fois un audio_latent et un audio_vae. Le VAE audio doit correspondre à l'espace latent audio (par ex., provenant d'un modèle de diffusion audio). Si aucun latent audio n'est connecté, la vidéo de sortie sera silencieuse.
• Prise en charge des formats et codecs : Les formats et codecs disponibles dépendent de l'installation FFmpeg (ou autre encodeur) sur votre système. Utilisez auto pour une expérience sans tracas ; si vous avez besoin d'un codec ou d'un conteneur spécifique, assurez-vous que l'encodeur requis est installé.
• Jetons de préfixe de nom de fichier : Vous pouvez utiliser la syntaxe de formatage de ComfyUI pour inclure la date, l'heure ou les valeurs de nœud. Par exemple :
  video/ComfyUI_%empty_latent_image.width%x%empty_latent_image.height%_%date:yyyy-MM-dd%
  produira des noms de fichier comme video/ComfyUI_512x512_2025-01-15_0001.mp4.
• Réglage de la taille des tuiles : Pour la plupart des cas d'utilisation, une tile_size de 512 et un overlap de 64 offrent un bon compromis entre mémoire et vitesse. Augmentez tile_size si la mémoire le permet ; diminuez-la si vous manquez de VRAM.
• Mosaïque temporelle : Cela n'est efficace qu'avec les VAE qui prennent en charge nativement la mosaïque temporelle. Si votre VAE ne le fait pas, la définition des paramètres temporels n'aura aucun effet.
• Incréments de pas : Tous les paramètres de tuile entiers appliquent la taille de pas définie dans le nœud (32 pour le spatial, 4 pour le temporel). Les valeurs non alignées sur le pas sont automatiquement arrondies.