mrvijaykr56/youtubeshorts

Compétence de Réalisateur Visuel & Génération d'Images YouTube Shorts

Cette compétence guide l'agent dans la génération de scènes verticales 9:16 cohérentes et cinématographiques pour YouTube Shorts en utilisant la capacité native generate_image d'Antigravity.

---

1. Cadre de Cohérence Visuelle (Synchronisation Personnage & Univers) 👥🌍

Lors de la génération de 5 à 20 images pour un Short, éviter les dérives stylistiques ou de personnage est essentiel. Si le visage, les vêtements ou l'environnement d'un personnage changent aléatoirement entre les scènes, l'immersion vidéo est rompue.

Les 3 Piliers de la Synchronisation Scène à Scène :

1. Le Plan d'ADN du Personnage :

   • Répliquez exactement la même formule en 5 parties pour chaque scène mettant en scène le personnage : [Nom + Âge/Genre] + [Coiffure & couleur] + [Traits du visage] + [Vêtements & couleurs exacts]
   • Exemple : "Maya, une archéologue de 26 ans aux cheveux bouclés foncés en queue de cheval, des taches de rousseur, portant une chemise de safari en lin olive et un collier en laiton avec une boussole"
   • Ne remplacez jamais par des termes génériques comme "elle ressemble à" ou "la femme".

2. L'Ancre de Monde & d'Éclairage :

   • Définissez une déclaration d'environnement partagée préfixée à toutes les invites de scène : [Cadre] + [Source lumineuse principale & température de couleur] + [Style d'ombres] + [Atmosphère]
   • Exemple : "Tombeau souterrain en grès de l'Égypte ancienne, lumière chaude ambra des torches projetant des ombres profondes et vacillantes, particules de poussière dorées flottantes, fond bleu cobalt foncé."

3. Chaînage de Référence Visuelle (ImagePaths) 🔗 :

   • L'outil generate_image d'Antigravity prend nativement en charge ImagePaths (transmission d'images précédentes comme références de conditionnement visuel).
   • Le Workflow :
     1. Générez la Scène 1 (personnage maître et éclairage d'établissement).
     2. Sauvegardez scene_1.jpg.
     3. Pour les Scènes 2, 3, 4..., passez ImagePaths: ["<chemin_vers_scene_1.jpg>"] à generate_image.
     4. Cela alimente directement Imagen 3 avec les caractéristiques latentes visuelles de la Scène 1, ancrant la forme du visage, la couleur des vêtements et les tons environnementaux sur toutes les scènes suivantes !

---

2. Validation Pré-Vol & Approbation Utilisateur 🛑

EXIGENCE CRITIQUE (Zéro Gaspillage de Tokens) : Avant d'exécuter tout appel generate_image :

1. Exécutez le Validateur de Storyboard Pré-Vol :

   .\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "chemin/vers/script.json"
   

   • Il doit y avoir 0 erreur bloquante (par exemple, pas de tokens textuels interdits, signaux 9:16 valides, dans la limite de 60 s Shorts).
2. Présentez le Storyboard Validé & le Style Artistique à l'utilisateur avec les statistiques de validation.
3. Demandez l'approbation explicite de l'utilisateur :

   "Le storyboard a passé toutes les vérifications de sécurité pré-vol (0 erreur, ~Xs de durée estimée). Souhaitez-vous que je procède à la génération de ces [N] images 9:16, ou préférez-vous modifier certaines scènes ou paramètres de style au préalable ?"

4. NE générez PAS d'images tant que l'utilisateur n'a pas donné une confirmation explicite.

---

3. Génération d'Images avec Antigravity generate_image

Pour chaque scène du storyboard (après approbation de l'utilisateur) :

1. Vérification des Doublons / Cache Pré-Génération 🛑 :

   • Vérifiez si scene_{X}.jpg ou scene_{X}.png existe déjà dans le dossier de destination (backend/output/<job_id>/) et est valide (>10 Ko).
   • Si elles existent déjà, sautez la régénération pour éviter le gaspillage de tokens, sauf si l'utilisateur demande explicitement de régénérer/cette scène spécifique.

2. Synthèse de l'Invite Finale (Assurer un Cadrage Caméra Distinct) :

   [Ancre de Monde] + [Ancre du Personnage] + [Action de la Scène & Angle Caméra DISTINCT] + [Modèle de Style Artistique Global] + [Composition Verticale 9:16]
   

   • Assurez-vous que le plan de caméra (par ex., grand-angle vs macro vs réaction) diffère de la scène précédente pour éviter de générer des images visuellement identiques.

3. Invoquez l'Outil : Appelez generate_image avec :

   • AspectRatio : "9:16"
   • ImageName : scene_1, scene_2, scene_3, etc. (strictement unique par scène).
   • Prompt : L'invite synthétisée.
   • ImagePaths : Pour les scènes 2..N, passez ["<chemin_vers_scene_1.jpg>"] pour le conditionnement visuel.

4. Génération par Lots : Générez les scènes séquentiellement ou par groupes de scènes (jusqu'à 20 par short).

---

4. Déploiement des Ressources vers le Pipeline YTShorts

Une fois les images générées par Antigravity :

1. Antigravity stocke les images générées dans le répertoire d'artefacts de la conversation : C:\Users\<utilisateur>\.gemini\antigravity-ide\brain\<id-conversation>\*.png

2. Copiez ou liez les images vers le répertoire de sortie/tâche YTShorts : d:\WorkSpace\YTShorts\backend\output\<job_id>\ Nommage standard requis par le backend :

   • scene_1.png
   • scene_2.png
   • scene_3.png
   • ...

3. Associez le JSON du storyboard : Sauvegardez script.json dans le même répertoire : d:\WorkSpace\YTShorts\backend\output\<job_id>\script.json

---

5. Déclenchement du Rendu Vidéo 🚀

Une fois les images et le script.json disposés dans backend/output/<job_id>/, exécutez l'outil d'assemblage autonome :

.\backend\venv\Scripts\python.exe backend\scripts\assemble_short.py --job_dir "backend/output/<job_id>" --voice in_female --caption_style tiktok --music lofi --resolution 1080p --transition dynamic

Cette commande unique automatise :

1. La synthèse de narration TTS haute définition (Edge-TTS / KittenTTS).
2. La génération de sous-titres ASS synchronisés au mot près via Whisper.
3. Le rendu de la vidéo .mp4 finale en 1080p/4K avec transitions optiques (xfade), mouvement panoramique/zoom Ken Burns, musique de fond avec ducking audio, et sous-titres incrustés en une seule étape !

---

6. Image de Marque de la Chaîne & Génération de Ressources Communautaires 🎨📊

Au-delà des scènes d'histoire verticales 9:16, le réalisateur visuel produit également des ressources marketing à l'aide de l'outil natif generate_image d'Antigravity :

1. Images pour Sondages de l'Onglet Communauté (Carré 1:1) :

   • Générez ou recadrez au centre les personnages en cartes carrées 1024x1024.
   • Placez les cartes dans backend/output/community_poll_assets/ (par ex. poll_1_character.jpg).
   • Les sondages par image génèrent 3 à 5 fois plus de portée sur les nouvelles chaînes que les publications textuelles standard.

2. Mascotte Avatar de la Chaîne (Carré 1:1) :

   • Générez un portrait de personnage Pixar 3D centré 1024x1024 avec des yeux expressifs et brillants, tenant un livre d'histoires lumineux.
   • Sauvegardez dans backend/output/channel_branding/channel_avatar_1024x1024.jpg.

3. Bannière Panoramique de la Chaîne (Paysage 16:9) :

   • Générez un paysage cinématographique panoramique 16:9 du monde récurrent de la chaîne.
   • Upscalez avec le filtre Lanczos à 2560x1440.
   • Sauvegardez dans backend/output/channel_branding/channel_banner_2560x1440.jpg.

4. Mandat Zéro API Externe :

   • Priorisez toujours l'outil natif generate_image d'Antigravity. Ne recourez jamais à des API d'images gratuites externes non vérifiées.