Communitygithub.com

H3 Video : Processus Complet de Court Métrage IA (MiniMax H3 +…

Processus complet de création de court-métrage IA avec dialogues, scènes animalières anthropomorphiques et histoires courtes, en local via ComfyUI (MiniMax H3, Qwen-Image, VoxCPM2). Gère le ton, le script, le doublage, les modèles de personnages, la première image, la génération H3, la vérification ligne par ligne, l’agrandissement, les sous-titres, le volume sonore et la couverture.

Qu'est-ce que H3 Video : Processus Complet de Court Métrage IA (MiniMax H3 +… ?

Ce pipeline IA complet pour ComfyUI automatise la production de court-métrages avec dialogues en plusieurs étapes clés : définition du ton et du style, écriture du script, doublage (TTS/VoxCPM2), création de modèles de personnages (Qwen-Image), génération de la première image, puis production H3 (MiniMax H3 Ref2VA). Une vérification ligne par ligne du locuteur, de la direction du regard et des raccords est intégrée avant l’étape d’agrandissement et d’export final. L’approche modulaire permet d’isoler et de corriger les erreurs sans refaire l’ensemble, en partant d’un plan validé par l’utilisateur. Le système repose sur des règles strictes (un seul locuteur par génération, regard cohérent, script source unique) et des scripts pratiques (speaker_grid.py, upscale_video.py, post_subtitle_loud.py) reliés à ComfyUI via l’URL COMFY_URL. Convient parfaitement aux utilisateurs de Claude Code, Cursor ou Codex souhaitant rationaliser leur flux de production vidéo IA.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/huihezuo-source/H3-Video/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

H3 Video : Processus Complet de Court Métrage IA

Ce processus est basé sur l’expérience de plusieurs projets réels. Idée centrale : planifier d’abord, valider chaque étape, et ne corriger que la couche qui pose problème.

Processus global (dans l’ordre, sans saut)

ÉtapeActionValidation
0Recherche : étudier des œuvres similaires et les méthodes existantes, noter les techniques—
1Planification : ton et style, script, segmentation, liste de génération (template dans templates/planification-modele.md)Validation par l’utilisateur
2Doublage : produire la voix off et les voix hors champ via TTS, mesurer la durée réelleL’utilisateur écoute et valide le timbre
3Modèle de personnage : une image en pied de face par personnage, dans l’univers de l’histoireValidation par l’utilisateur
4Première image : une par segment, juste au début de l’actionNe pas générer la vidéo avant validation
5Génération : produire un brouillon avec les réglages les plus rapides—
6Vérification ligne par ligne : locuteur, regard, raccordsEn cas d’erreur, ne refaire que ce segment
7Agrandissement, sous-titres, volume sonore, couvertureValidation finale par l’utilisateur
8Rétrospective : noter chaque point à vérifier du plan, documenter les leçons dans la base de connaissances—

Sept règles absolues

  1. Le style doit servir le ton de l’histoire. Avant de dessiner quoi que ce soit, rédiger une section « Ton et style » : source lumineuse et obscurité, palette de couleurs, état des vêtements (neufs, sales), expressions, ambiance du décor. Les modèles doivent aussi être dans cet univers, pas sur fond gris de studio. Poser la question « Cela appartient‑il à cette histoire ? » avant chaque image. L’erreur la plus fréquente est d’associer un visage parfait d’idole à une histoire sombre.
  2. Une génération = une seule source sonore. Les voix off et hors champ ne doivent jamais passer par H3, sinon le personnage à l’écran synchronisera ses lèvres sur la voix off, même avec « bouche fermée » dans le prompt. Pour les segments avec voix off, générer une vidéo sans dialogue et ajouter le son au montage.
  3. Personnage présent mais sans dialogue : ne pas lui donner de réplique lors de la génération. Pour un personnage qui doit être caché pendant qu’un autre parle, utiliser un plan de dos ou par‑dessus l’épaule.
  4. Le script est la seule source. Chaque ligne précise le type (dialogue/voix hors champ), le locuteur, le regard, le texte original. Budget d’environ 3 caractères par seconde, chaque ligne doit être terminée dans son segment. Aucune étape ultérieure ne doit modifier le script.
  5. Regard : le locuteur regarde son interlocuteur, l’interlocuteur regarde le locuteur. Chaque ligne du prompt doit clairement indiquer qui regarde qui.
  6. Si la première image est erronée, la refaire. Ne pas essayer de la corriger par le prompt. Vérifier à la résolution originale : mains, yeux, bouche, accessoires, objets superflus.
  7. Ne pas livrer sans vérification ligne par ligne. Pour chaque réplique, extraire une grille d’images denses avec scripts/speaker_grid.py et répondre à une seule question fermée : « Qui parle : A / B / les deux / aucun ». Comparer avec le script. Une grille de 4 images éparses peut manquer des erreurs.

Principes de génération et de reprise

  • D’abord le brouillon, puis l’agrandissement : utiliser la résolution la plus rapide, valider, puis n’agrandir que la version validée.
  • Analyser l’échec avant de corriger : déterminer si le problème vient du prompt, de la première image, du script ou du montage, puis décider quelle couche modifier. Une erreur commune à plusieurs segments se corrige sur la référence partagée (modèle de personnage) ; une erreur isolée se corrige uniquement sur ce segment, un seul changement à la fois.
  • Écrire des prompts positifs, éviter les « ne pas… ». Pour éviter quelque chose, le corriger en amont (première image, modèle).
  • Enregistrer pour chaque segment la première image, le modèle, la graine aléatoire et le prompt, afin de ne refaire qu’un segment si nécessaire.
  • Test des 2 premières secondes : le spectateur doit comprendre immédiatement ce qu’il regarde.

Documents de référence

  • references/details-et-lecons-processus.md : détails de chaque étape et pièges rencontrés.
  • references/noeuds-et-parametres-comfyui.md : nœuds et paramètres pour Qwen‑Image (modèles), Qwen‑Image‑Edit (retouche), VoxCPM2 (clonage vocal), H3 Ref2VA, ainsi que les solutions aux pannes connues.
  • references/recherche-pipelines-open-source.md : comparaison de 9 projets vidéo IA open source, ce qui est intéressant à reprendre ou non.
  • templates/planification-modele.md : modèle de document de planification incluant script et tableau de validation.

Scripts

Tous les scripts se connectent à ComfyUI via la variable d’environnement COMFY_URL (par défaut http://127.0.0.1:8188). Voir scripts/README.md pour l’utilisation.

ScriptRôle
t2i_masters.pyGénérer en lot les modèles de personnages avec Qwen‑Image (préfixe de style + description par personnage)
edit_image.pyRetoucher localement une image avec Qwen‑Image‑Edit, sans modifier le reste
voice_design.pyConcevoir la voix d’un personnage avec VoxCPM2 selon une description textuelle, produire deux échantillons A/B
tts_clone.pyCloner un timbre vocal avec VoxCPM2 à partir d’un échantillon de référence, produire en lot la voix off
h3_ref2va.pyAssembler et soumettre le workflow H3 Ref2VA (image de référence, audio de référence, ancrage de la première image)
wait_download.pyAttendre la fin de la tâche et télécharger toutes les sorties
ws_progress.pyAfficher la progression de la tâche (nécessite le client_id utilisé lors de la soumission)
asr.pyTranscrire avec faster‑whisper pour vérifier que le doublage correspond mot pour mot
speaker_grid.pyGénérer une grille d’images denses par ligne de script pour la vérification du locuteur
upscale_video.pyAgrandir la vidéo image par image avec RealESRGAN
post_subtitle_loud.pyIncruster les sous‑titres + appliquer deux passes loudnorm pour atteindre -14 LUFS
make_cover.pyGénérer les couvertures au format 3:4 et 9:16

Skills associés