Guide Complet du Flux de Travail HunyuanVideo Image-to-Video GGUF, FP8 et ComfyUI Native avec Exemples

Tencent a officiellement lancé le modèle image-vers-vidéo HunyuanVideo le 6 mars 2025. Le modèle est maintenant open-source et peut être trouvé sur HunyuanVideo-I2V.

Voici le diagramme d’architecture globale de HunyuanVideo :

ComfyUI prend désormais en charge nativement le modèle HunyuanVideo-I2V, et les développeurs de la communauté kijai et city96 ont mis à jour leurs nœuds personnalisés pour prendre en charge le modèle HunyuanVideo-I2V.

En plus du modèle officiel de Tencent, voici d’autres versions compilées par ComfyUI Wiki :

• Version officielle reconditionnée de ComfyUI (ne nécessite pas de plugin) : Comfy-Org/HunyuanVideo_repackaged
• Version de Kijai (nécessite ComfyUI-HunyuanVideoWrapper) : Kijai/HunyuanVideo_comfy
• Version empaquetée de city96 (nécessite ComfyUI-GGUF) : city96/HunyuanVideo-I2V-gguf

Dans cet article, nous fournirons des instructions complètes d’installation de modèles et des exemples de flux de travail pour chacune de ces versions.

Cet article se concentre sur les flux de travail image-vers-vidéo. Si vous souhaitez en savoir plus sur le flux de travail texte-vers-vidéo de Tencent Hunyuan, veuillez consulter Guide et exemples de flux de travail texte-vers-vidéo de Tencent Hunyuan.

Flux de travail officiel de ComfyUI pour HunyuanVideo I2V

Ce flux de travail provient de la documentation officielle de ComfyUI.

Avant de commencer ce tutoriel, veuillez consulter Comment mettre à jour ComfyUI pour mettre à jour votre ComfyUI vers la version la plus récente afin d’éviter l’absence des nœuds Comfy_Core suivants pour HunyuanVideo :

• HunyuanImageToVideo
• TextEncodeHunyuanVideo_ImageToVideo

1. Fichier de flux de travail HunyuanVideo I2V

Téléchargez le fichier de flux de travail ci-dessous, puis faites-le glisser dans ComfyUI, ou utilisez le menu Workflows -> Open (ctrl+o) pour charger le flux de travail.

Téléchargement du flux de travail au format JSON

2. Téléchargements des modèles HunyuanVideo I2V

Les modèles suivants proviennent de Comfy-Org/HunyuanVideo_repackaged. Veuillez télécharger ces modèles :

• llava_llama3_vision.safetensors
• clip_l.safetensors
• llava_llama3_fp16.safetensors
• llava_llama3_fp8_scaled.safetensors
• hunyuan_video_vae_bf16.safetensors
• hunyuan_video_image_to_video_720p_bf16.safetensors

Après le téléchargement, organisez les fichiers selon la structure ci-dessous et enregistrez-les dans les dossiers correspondants sous ComfyUI/models :

ComfyUI/
├── models/
│   ├── clip_vision/
│   │   └── llava_llama3_vision.safetensors
│   ├── text_encoders/
│   │   ├── clip_l.safetensors
│   │   ├── llava_llama3_fp16.safetensors
│   │   └── llava_llama3_fp8_scaled.safetensors
│   ├── vae/
│   │   └── hunyuan_video_vae_bf16.safetensors
│   └── diffusion_models/
│       └── hunyuan_video_image_to_video_720p_bf16.safetensors

3. Image d’entrée

Téléchargez l’image ci-dessous comme image d’entrée

Complétez la vérification de chaque nœud du flux de travail HunyuanVideo I2V

Référez-vous à l’image pour compléter la vérification du contenu de chaque nœud et assurer le bon fonctionnement du flux de travail

1. Vérifiez le nœud DualCLIPLoader :

• Assurez-vous que clip_name1 : clip_l.safetensors est correctement chargé
• Assurez-vous que clip_name2 : llava_llama3_vision.safetensors est correctement chargé

2. Vérifiez le nœud Load CLIP Vision : Assurez-vous que llava_llama3_vision.safetensors est correctement chargé
3. Dans le nœud Load Image, téléchargez l’image d’entrée fournie précédemment
4. Vérifiez le nœud Load VAE : Assurez-vous que hunyuan_video_vae_bf16.safetensors est correctement chargé
5. Vérifiez le nœud Load Diffusion Model : Assurez-vous que hunyuan_video_image_to_video_720p_bf16.safetensors est correctement chargé

• Si vous rencontrez une erreur running out of memory. pendant l’exécution, vous pouvez essayer de définir weight_dtype sur le type fp8

6. Cliquez sur le bouton Queue ou utilisez le raccourci clavier Ctrl(cmd) + Enter pour exécuter la génération de vidéo

Version Kijai HunyuanVideoWrapper

1. Installation des nœuds personnalisés

Vous devez installer les nœuds personnalisés suivants :

• ComfyUI-VideoHelperSuite
• ComfyUI-WanVideoWrapper
• ComfyUI-KJNodes

Si vous ne savez pas comment installer des nœuds personnalisés, veuillez consulter le Guide d’installation des nœuds personnalisés de ComfyUI

2. Téléchargements des modèles

• hunyuan_video_vae_bf16.safetensors
• hunyuan_video_I2V_fp8_e4m3fn.safetensors

Les fichiers téléchargés doivent être organisés selon la structure ci-dessous et enregistrés dans les dossiers correspondants sous ComfyUI/models :

ComfyUI/
├── models/
│   ├── vae/
│   │   └── hunyuan_video_vae_bf16.safetensors
│   └── diffusion_models/
│       └── hunyuan_video_I2V_fp8_e4m3fn.safetensors

3. Fichier de flux de travail HunyuanVideo I2V

Complétez la vérification de chaque nœud du flux de travail HunyuanVideo I2V

Référez-vous à l’image pour compléter la vérification du contenu de chaque nœud et assurer le bon fonctionnement du flux de travail

1. Dans le nœud Load Image, téléchargez l’image que vous souhaitez utiliser pour la génération d’image vers vidéo
2. Dans le nœud HunyuanVideo VAE Loader, assurez-vous que hunyuan_video_vae_bf16.safetensors est correctement chargé
3. Dans le nœud HunyuanVideo Model Loader, assurez-vous que hunyuan_video_I2V_fp8_e4m3fn.safetensors est correctement chargé
4. Modifiez le texte du prompt dans le nœud HyVideo I2V Encode, entrez la description de la vidéo que vous souhaitez générer
5. Cliquez sur le bouton Queue ou utilisez le raccourci clavier Ctrl(cmd) + Enter pour exécuter la génération de vidéo

Version city96 GGUF

1. Installation des nœuds personnalisés

Vous devez installer le nœud personnalisé suivant :

• ComfyUI-GGUF

Si vous ne savez pas comment installer des nœuds personnalisés, veuillez consulter le Guide d’installation des nœuds personnalisés de ComfyUI

2. Téléchargements des modèles

Les modèles pour cette version sont essentiellement les mêmes que la version officielle de ComfyUI, à l’exception du modèle HunyuanVideo lui-même. Veuillez vous référer à la section de la version officielle de ComfyUI de cet article pour les téléchargements manuels.

Vous devez visiter city96/HunyuanVideo-I2V-gguf pour télécharger la version du modèle dont vous avez besoin et enregistrer le fichier de modèle gguf correspondant dans le dossier ComfyUI/models/unet :

ComfyUI/
├── models/
│   ├── clip_vision/
│   │   └── llava_llama3_vision.safetensors
│   ├── text_encoders/
│   │   ├── clip_l.safetensors
│   │   ├── llava_llama3_fp16.safetensors
│   │   └── llava_llama3_fp8_scaled.safetensors
│   ├── vae/
│   │   └── hunyuan_video_vae_bf16.safetensors
│   └── unet/
│       └── hunyuan-video-i2v-720p-Q4_K_M.gguf // Dépend de la version GGUF que vous avez téléchargée

3. Fichier de flux de travail HunyuanVideo I2V

Complétez la vérification de chaque nœud du flux de travail HunyuanVideo I2V

Référez-vous à l’image pour compléter la vérification du contenu de chaque nœud et assurer le bon fonctionnement du flux de travail

1. Vérifiez le nœud DualCLIPLoader :

• Assurez-vous que clip_name1 : clip_l.safetensors est correctement chargé
• Assurez-vous que clip_name2 : llava_llama3_vision.safetensors est correctement chargé

2. Vérifiez le nœud Load CLIP Vision : Assurez-vous que llava_llama3_vision.safetensors est correctement chargé
3. Dans le nœud Load Image, téléchargez l’image d’entrée fournie précédemment
4. Vérifiez le nœud Load VAE : Assurez-vous que hunyuan_video_vae_bf16.safetensors est correctement chargé
5. Vérifiez le nœud Load Diffusion Model : Assurez-vous que le modèle GGUF HunyuanVideo correspondant est correctement chargé
6. Cliquez sur le bouton Queue ou utilisez le raccourci clavier Ctrl(cmd) + Enter pour exécuter la génération de vidéo