kingsizestrj/SKILLS

Vidéos réalistes avec l'IA de Voltec avec le personnage de la marque (ElevenLabs + HyperFrames)

Production et édition de toute vidéo réaliste avec l'IA de Voltec mettant en scène le personnage de la marque (Reels, Stories ou publicité 9:16, pour toute campagne, saison, thème ou scénario) : persona IA dans un lieu réel → snapshot approuvé → Veo 3.1 image-to-video → narration avec voix clonée → montage HyperFrames avec sous-titres, CTA et QR. Sont détaillés ici le flux, les règles, les éléments fixes Voltec et les variables qui changent à chaque vidéo. Les corps JSON, prompts complets et commandes longues se trouvent dans references/.

Cas de référence testé : le Reels "Verão Conectado" (15/10/2026 ; 20,5 s, 1080x1920, 24 fps ; livré en v5). Ses valeurs apparaissent sous forme "ex. : Verão Conectado" et ne sont jamais la norme : ce qui est de la campagne est une variable (§1b), et l'exemple renseigné est au §7.2.

• [Voltec] marque ce qui est fixe de Voltec avec le personnage ou de la zone desservie (Grussaí et région). "Ex. : Verão Conectado" marque une valeur propre à la campagne de référence. Le reste vaut pour toute publicité IA.
• Niveau de preuve, comme dans les references : [vécu] a eu lieu dans la session et a été vérifié ; [appliqué] est issu de la recherche ou des critiques et a été intégré dans les prises approuvées ; [recherche] uniquement de la recherche ; [non testé] dérivé des règles, sans génération (§8).
• $SKILL = dossier de ce SKILL.md ; $PROJ = dossier du projet vidéo. Les variables shell ne passent pas d'un appel Bash à un autre : répéter le préambule de la section 5 à chaque appel.
• Les prompts de génération sont en anglais. Les textes pour le client, la narration et les sous-titres sont en portugais.
• La clé API se trouve dans ~/.config/elevenlabs/env (chmod 600) et scripts/el.py la lit sans l'afficher. Ne jamais utiliser echo, cat, env, curl -v ou set -x avec elle, ni l'écrire dans un fichier, un prompt ou un message.
• Vous n'entendez pas l'audio : vérifiez avec STT (texte et audio_event), le spectrogramme du segment et ebur128, et listez dans la page de la porte les instants que le client doit écouter.

1. Quand utiliser

• [Voltec] Toute vidéo réaliste avec l'IA de Voltec mettant en scène le personnage de la marque, qui doit sembler filmée pour de vrai par quelqu'un : Reels, Stories ou publicité ; toute campagne, saison ou thème (promotion saisonnière, institutionnel, astuce Wi-Fi, support, inauguration, Black Friday) ; scénario réel de la zone desservie (Grussaí, Atafona, Chapéu do Sol, São João da Barra ; ce qui sert de scénario : §7.1) ou intérieur (maison, magasin, voiture). Scénario, tenue ou format jamais généré : §8.
• Génération via l'API ElevenLabs : image (snapshot), vidéo (Veo 3.1 ; Seedance via l'API uniquement avec autorisation, ou manuellement dans l'application), narration avec voix clonée, SFX et STT.
• Montage dans HyperFrames : coupes par image, mixage, cartes, sous-titres synchronisés, CTA et QR.
• Ajustement d'une vidéo IA déjà livrée : découpage d'une prise, changement de variation, changement d'une phrase ou du CTA, version sous-titrée, affinement de l'identité.
• Avec elle s'adressant à la caméra ("elle parle", "elle s'exprime", "elle explique") : mode parlant, dans references/modo-falando.md. Veo 3.1 génère le plan avec la parole et sts.py échange la voix pour Radassa. [vécu : test de 13 s approuvé le 15/10/2026]
• [GÉNÉRAL] Autre marque ou personne : ce qui n'est pas [Voltec] s'applique, avec adaptation (remplacer le §7.1 et renseigner les variables du §1b). Projet de référence : /home/syllas/hyperframes/voltec-reels-ia/ (Verão Conectado ; lecture seule).
• Ne convient pas pour des motion graphics sans personne ni scène générée (dans ce cas, seul HyperFrames suffit) ni pour des sujets Voltec sans vidéo (réseau, GenieACS, TR-069).

Standard de qualité (exigence de Voltec ; à utiliser comme standard pour tout projet) : réalisme maximal ; caméra crédible, comme si quelqu'un filmait vraiment ; environnement réel, sans changement brusque ; aucune anomalie dans l'objet tenu à la main ; lieux réels avec photos sous licence (ou du client lui-même) montrées au client ; snapshot approuvé avant toute vidéo ; prompts détaillés (mouvement, peau, capture audio avec bruits réels) ; recherche des bonnes pratiques avant de générer.

1b. Démarrage rapide : toute nouvelle vidéo Voltec avec le personnage

1. Lire dans cet ordre : ce SKILL.md (avec le §7) → persona-e-marca-voltec.md §1–4 et §6–7 → le scénario : à Grussaí, locais-grussai.md §1, §3 (avec le tableau "Autres saisons") et §4 ; ailleurs ou en scène intérieure, le §8 de ce fichier, persona-e-marca-voltec.md §10 et locais-grussai.md §7–§10 → prompts-principios.md §1 (avec la "Checklist du prompt") → uniquement le modèle de prompts-moldes.md §2 le plus proche de la scène (2.1 amie filmant, 2.2 pose au même endroit, 2.3 selfie, 2.5–2.6 vidéo ; nouvelle scène : 2.9–2.10). Le reste, seulement dans la phase où il sera nécessaire. prompts-moldes.md et persona-e-marca-voltec.md dépassent la limite d'une lecture Read : trouvez la section avec Grep (ex. : ^### 2\.9, ^## 10) et lisez avec offset/limit.
2. Déjà décidé (fixes Voltec ; ne pas redemander) : persona du compte, avec les assets na7keiYvPpGArmyghOpk, pUgU1HXgmdqXfP02iR8T et ZY1iDcJLhPFklahPnvkM déjà dans le compte (ne pas retélécharger ; persona §4) et les ancres de visage, peau et mains (persona §3.1–3.3) ; voix "Radassa 100%" 4yvYc2GSakxLWMhlsd6b, eleven_v4, 0.45/0.85, "pt", et le A/B est désormais entre 2 seeds de cette voix ; prononciation vol-TÉC ("Voltéc" en TTS, "Voltec" à l'écran) ; sans bijoux ni tatouages ; sans musique ; logo, couleurs, polices et villes (§7.1) ; les règles de réalisme, prompt et QA (§3, qa-checklist.md) et les portes (§2). Modèle : Veo 3.1 via l'API, choisi le 15/10/2026 ; ne revenir à la question que si le test d'accès sans frais (modelos-e-custos.md §2.2) ou la révision du catalogue de la Phase 1 changent la donne.
3. Variables de la vidéo : demander toujours, avant d'écrire la narration (dans le chat, cela suffit). Exemple renseigné au §7.2.
   • Viennent du client (ne jamais inventer) : thème et format (Reels, Stories, publicité) ; narration en off (par défaut) ou elle s'adressant à la caméra (references/modo-falando.md), et dans ce cas la parole de chaque prise ; offre, prix, conditions et période ; publicité payante (bouton "En savoir plus" + QR) ou publication organique ("lien dans la bio") ; destination du QR (le page_id=674 est la page "Verão Conectado 2026" : ne pas le réutiliser sans confirmation du client) ; si les crédits des photos CC BY vont dans la légende de la publication.
   • Demander et proposer (le client approuve à la porte 1 ou 2) : scénario, heure et lumière ; durée ; scénario des prises (par prise : lieu, objet tenu et son ambiant) ; tenue ; accroche ; carte de campagne ; texte du matelas SFX.
4. Refaire par scène, saison ou scénario (rien de tout cela ne se copie de l'exemple) : ancre de tenue dans le style de la persona §3.4 (opaque, sans motif ni logo ; tissu lisse ou à grands motifs, car un motif fin ondule) ; lumière selon le soleil calculé pour le lieu, la date et l'heure (locais-grussai.md §8 ; à Grussaí, le tableau "Autres saisons" du §3 : en hiver, soleil à ~19,5° vers 15h40 et soleil d'après-midi ~293–304° ; dans la selfie en contre-jour, elle marche vers le sud et la mer reste à droite) ; vent (seul celui de l'été a été recherché : rechercher avant) ; son ambiant du lieu (dans le prompt vidéo et le matelas SFX) ; extraits de lieu du negative_prompt (prompts-moldes.md §2.6) ; espace libre dans le snapshot pour l'accroche, dans une zone lisse du cadre (le #q1 du template se trouve en haut à droite ; ex. : Verão Conectado : ciel ouvert en T1) ; textes de la campagne dans les tokens __…__ du template : accroche, titre de la carte en 1 ou 2 parties avec icône optionnelle (ex. : "VERÃO ☀ CONECTADO", avec le soleil) et offre ; texte du matelas SFX.
5. Nouveau projet et nouvelle page : $HOME/hyperframes/<campagne> et un nouvel Artifact. Ne pas republier sur l'URL de Verão Conectado (§7.2).

2. Flux en phases et portes

Chaque porte est une page (Artifact) avec un A/B côte à côte et des questions numérotées. Demander une réponse courte au format "T1-A, T2-A, T3-A, voix A, modèle 1" ; c'est ce qui a accéléré les décisions.

• Page : une par projet, republiée à chaque porte (même fichier, même URL), avec la porte actuelle en haut et les décisions déjà prises en bas ; nouvelle campagne = nouvelle page. Les médias vont comme fichiers de support dans media/ : snapshots en JPG (~200 Ko chacun dans la session), narration en MP3 et prévisualisation de la vidéo en MP4 avec poster JPG (~11 Mo dans la session ; limite de 15 Mo par fichier). Structure modèle (ex. : la page de Verão Conectado) : lire https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh (Artifact, action: "read"). Par prise : A/B, caméra, action, son capté, narration, texte à l'écran et temps. Ensuite : narration A/B avec tableau des temps, chemins de modèle, lieux avec crédit et un encadré avec le format de réponse.
• Registre : noter les réponses de chaque porte dans $PROJ/DECISOES.md et dans la section "Décisions" de la page.
• Fusionner les portes : fusionner les portes 1, 2 et 3 en une seule page lorsque l'offre, le CTA (payant vs organique) et la destination du QR ont déjà été répondus. Sinon, faire d'abord la porte 1 (dans le chat, cela suffit) et ne pas générer de snapshot ni de narration. La narration montrée dans un storyboard avant les réponses est provisoire : après celles-ci (prononciation, CTA, offre), générer la narration finale avec la voix choisie (2 seeds, ~300 crédits chacune), avant les vidéos. Ex. : Verão Conectado : narracao_radassa100 dans le storyboard et narracao_v2_A_s1 après les réponses.
• Ne jamais fusionner : vidéo avant l'OK de la porte 3.

Phase 1 : Recherche et plan (0 crédit)

• Rechercher en parallèle (4 fronts : modèles, réalisme/anti-hallucination, lieux et API ; avec sous-agents en parallèle, si possible). Ensuite, écrire le scénario et le plan des prises au format du storyboard : par prise, lieu et heure, qui filme et caméra, action en 2–3 temps, objet, son capté, phrase de la narration, texte à l'écran et temps.
• Effectuer 2 critiques indépendantes avant de dépenser : un sous-agent par focus ; sans sous-agents, un passage séparé par focus. Technique = champs et limites de l'API (api-elevenlabs.md §3.3), durée/1080p, coûts et modération (prompts-principios.md §4). Réalisme = "Checklist du prompt" de prompts-principios.md §1 + lumière et géométrie (soleil calculé dans locais-grussai.md §8 ; scène intérieure ou nocturne : §8 de ce fichier). Chacune retourne problème, prise, sévérité et correction.
• Les classements changent vite : si modelos-e-custos.md a plus de ~2 mois, consulter à nouveau. À partir du 17/11/2026, vérifier si veo-3.1-generate-001 existe toujours. Tester l'accès à chaque modèle sans dépenser (§2.2 du même fichier).
• Client déjà servi : les references sont la recherche. Ne refaire que l'élément ci-dessus et ce qui est nouveau dans la campagne : saison (le vent hors été n'a pas été recherché), scénario hors exemple ou sans photo ouverte (demander des photos au client, locais-grussai.md §7 ; ce qui n'a pas été recherché est au §8 et dans locais-grussai.md §10), tenue et objet à la main (persona §3.4). Maintenir les 2 critiques avant de dépenser.
• Porte 1, le client reçoit : modèle recommandé avec score daté et coût prévu ; scénario avec la narration écrite ; questions numérotées : CTA de publicité payante ou de publication organique, destination du QR, prononciation de la marque, offre et prix (viennent du client ; ne jamais inventer), persona et refs (prévenir si une ref a un autre visage), voix et consentement, musique (par défaut : sans), durée, tatouages et bijoux, étiquette "Informations IA", crédit des photos. [Voltec] Ne demander que ce que la section 1b ordonne.

Phase 2 : Lieux réels (0 crédit)

• Photos avec la licence lue sur la page de la photo et le lieu prouvé (géolocalisation, OpenStreetMap) : méthode dans locais-grussai.md §7. Calculer le soleil pour l'heure de la scène (locais-grussai.md §8) et vérifier le vent du lieu. Seules CC0 et CC BY vont à l'API ; photo NC ne sert que de référence pour écrire le prompt. Scène intérieure (maison, magasin, voiture) : photos du client lui-même, sans plaque ni enseigne lisible (§8).
• Porte 2, le client reçoit : planche contact (vert = peut aller à l'API ; rouge = NC), crédits, le scénario unique proposé (un lieu et une heure ; ex. : Verão Conectado : la véranda et le sable devant, un après-midi d'été) et l'heure de la lumière.

Phase 3 : Snapshots et narration (porte obligatoire)

• Snapshot = 1er plan de chaque prise, sur gpt-image-2.5-sunburst (9:16, 2K, high), avec 2 variations par prise. Réviser tous avec qa-checklist.md §A.
• Générer T1 A/B en premier. Choisir soi-même la meilleure selon qa-checklist.md §A et l'utiliser comme base : la prise suivante au même lieu est une édition de celle-ci, avec la caméra au même point ; nouveau lieu est une nouvelle image avec elle comme Image 1 (ex. : Verão Conectado : T2 et T3 sont issus du T1-A 5vBTv3B9FOt44Vu8jMY4 avant le storyboard). À la porte 3, dire quelles prises dérivent du T1-X. Si le client choisit l'autre T1, refaire les dérivées à partir de celui-ci (2 images par prise ; ex. : Verão Conectado : T2 et T3, 4 images, ≈2,2 mille crédits) avant toute vidéo.
• Narration entière dans une requête, avec 2 voix ou 2 seeds. La durée mesurée par l'alignement définit les coupes. Vérifier l'accent tonique de la marque et le texte parlé (stress.py + STT).
• Porte 3, le client reçoit : A/B de chaque prise côte à côte avec la référence du visage, lecteurs de la narration A/B, les photos des lieux et la question du modèle. S'arrêter jusqu'à la réponse et conserver les generation_id approuvés.

Phase 4 : Vidéos, 2 variations par prise

• Veo 3.1, start_frame = generation_id du snapshot approuvé, 9:16, 1080p, 8 s, avec audio, seeds 20260115 et 20260116. Le prompt ne décrit que mouvement, caméra et son (prompts-moldes.md §2.5–2.6). Le personnage ne parle pas, sauf en mode parlant (references/modo-falando.md §4).
• 19.391 crédits par génération, 2 par prise (ex. : Verão Conectado, 3 prises × 2 variations = 116.346). Dans la session, 6 générations en parallèle ont été prêtes en ~3 min (variable). Le client ne reçoit rien dans cette phase.

Phase 5 : Sélection et QA de chaque variation (porte interne)

• Planche contact à 2 ips, bandes numérotées à 24 ips (bouche) et à 8 ips (mains et objet), et STT de l'audio natif (qa-checklist.md §B). Noter le plan de chaque défaut (prise Veo = 192 plans ; plan = secondes × 24) et choisir un in/out qui l'évite. Si la variation A n'a pas de fenêtre propre, utiliser la B. Si les deux échouent, regénérer en changeant UNE variable.
• Regénération au-delà des 2 variations : dans la réserve d'1 tour approuvé à la porte 1 ; au-delà, demander l'OK avec le motif et le coût (19.391 par prise).
• Le client ne reçoit quelque chose ici que s'il y a un vrai doute : les 2 variations en boucle sur la page.

Phase 6 : Montage (0 crédit, hors matelas le son ajouté et le poster du QR)