Processeur Vidéo
Traite des fichiers vidéo pour la création de contenu YouTube et génère des graphiques pour les réseaux sociaux. Cette compétence offre quatre capacités principales :
- Transcription et chapitres : Convertit les clips vidéo en transcriptions horodatées, sous-titres SRT et chapitres YouTube générés par IA
- Génération de miniatures YouTube : Crée des miniatures YouTube alimentées par IA avec des références de visage et une correspondance de style
- Images pour publications LinkedIn : Génère des infographies et images professionnelles pour publications LinkedIn
- Génération d'images génériques : Crée des images personnalisées pour toute plateforme avec des dimensions et des prompts flexibles
Quand Utiliser Cette Compétence
Utilisez cette compétence lorsque l'utilisateur :
- Souhaite transcrire des fichiers vidéo ou des clips
- A besoin de générer des chapitres YouTube
- Souhaite régénérer des chapitres à partir de transcriptions existantes
- Veut créer des miniatures YouTube
- Veut créer des images ou infographies pour publications LinkedIn
- Souhaite générer des images pour d'autres plateformes (Instagram, Twitter, Facebook, etc.)
- Mentionne l'échange de visage pour les miniatures
- Demande à fournir des références de visage ou de style pour les graphiques
Choisir le Bon Outil de Génération d'Images
La compétence fournit trois scripts de génération d'images. Choisissez en fonction de la plateforme et des besoins :
Utilisez thumbnail.py (miniatures YouTube) lorsque :
- L'utilisateur mentionne "YouTube", "miniature" ou "vignette vidéo"
- Un rapport d'aspect 16:9 est demandé
- Un style dramatique et accrocheur avec des visages est souhaité
- Par défaut : 1920x1080
Utilisez linkedin-post.py (infographies LinkedIn) lorsque :
- L'utilisateur mentionne "LinkedIn", "publication LinkedIn" ou "infographie professionnelle"
- Une infographie au format carré est demandée
- Un thème professionnel et sombre, sans visage
- Par défaut : 1200x1200
Utilisez image-gen.py (générique) lorsque :
- Des dimensions personnalisées sont spécifiées (Instagram, Twitter, Facebook, etc.)
- La plateforme n'est ni YouTube ni LinkedIn
- L'utilisateur demande explicitement un outil flexible/personnalisé
- L'utilisateur fournit un prompt complet avec des exigences de style spécifiques
- Paramètre requis :
--dimensions LARGEURxHAUTEUR
Priorité : Préférez toujours thumbnail.py ou linkedin-post.py lorsque le cas d'usage correspond. Utilisez image-gen.py comme solution de repli pour les autres plateformes ou besoins personnalisés.
Installation et Prérequis
Le processeur vidéo se trouve dans le dossier video-processor/ du dépôt du projet.
Prérequis :
- Python 3.9+
- Gestionnaire de paquets uv
- FFmpeg (pour la transcription)
- Clé API OpenAI (pour la transcription Whisper)
- Clé API Gemini (pour les chapitres et miniatures)
- Jeton API Replicate (optionnel, pour l'échange de visage)
Configuration de l'environnement :
cd video-processor
uv sync
# Assurez-vous que .env existe avec les clés API nécessaires
1. Transcription Vidéo et Chapitres
Commande de Transcription de Base
Transcrivez des clips vidéo et générez une transcription, des sous-titres et des chapitres :
cd video-processor
uv run transcribe.py <chemin_du_dossier>
Exemple :
uv run transcribe.py ./ma-video-youtube/
Format d'Entrée
Les vidéos doivent se trouver dans un dossier avec des préfixes numériques pour l'ordre :
ma-video-youtube/
├── 1.mp4 # Introduction
├── 2.mp4 # Contenu principal
├── 3.mov # Démonstration
└── 4.mp4 # Conclusion
Formats supportés : MP4, MOV, MKV, AVI, WEBM, M4V
Fichiers de Sortie
Le script génère trois fichiers dans le même dossier :
-
transcript.md - Markdown avec horodatages
# Transcription [00:00] Bon retour sur la chaîne... [00:15] Aujourd'hui, nous allons parler de... -
transcript.srt - Sous-titres SRT pour éditeurs vidéo/YouTube
1 00:00:00,000 --> 00:00:15,500 Bon retour sur la chaîne... -
chapters.txt - Suggestions de chapitres YouTube (générées par IA)
0:00 Introduction 2:30 Configuration 5:45 Tutoriel principal
Fonctionnalités
- Support multi-clips : Traite les clips numérotés avec un calcul automatique du décalage temporel
- Support des longues vidéos : Découpe automatiquement les vidéos de plus de 20 minutes (limite API)
- Transcription horodatée : Format Markdown avec horodatages précis
- Chapitres IA : Gemini génère des marqueurs de chapitres contextuels
Régénérer Uniquement les Chapitres
Si vous avez déjà une transcription et souhaitez régénérer les chapitres :
cd video-processor
uv run chapters.py <transcript.md ou chemin_du_dossier>
Exemples :
# Pointer directement vers le fichier de transcription
uv run chapters.py ./ma-video/transcript.md
# Ou pointer vers le dossier contenant transcript.md
uv run chapters.py ./ma-video/
Cas d'utilisation :
- Ajuster les chapitres sans retranscrire
- Régénérer après modification de la transcription
- Utiliser un modèle Gemini différent
Remarques Importantes
- Les clips doivent se trouver dans un dossier plat (pas de sous-dossiers)
- Les vidéos sont traitées dans l'ordre numérique par préfixe de nom de fichier
- Coût estimé : ~$0.006 par minute d'audio (API Whisper)
- Les longues vidéos sont automatiquement découpées pour gérer les limites API
- Connexion Internet requise
2. Génération de Miniatures
Commande de Base pour Miniature
Générez des miniatures YouTube alimentées par IA :
cd video-processor
uv run thumbnail.py "votre idée de miniature ici"
Comportement par défaut :
- Génère 3 variantes
- Sauvegarde dans :
./output/Thumbnails/[AAAA-MM-JJ]/ - Utilise
assets/face.jpgs'il existe - Sortie : fichiers PNG 1920x1080
- Directives de marque : Consultez references/brand-guidelines.md pour la palette de couleurs, la composition et les meilleures pratiques de style
Paramètres de la Miniature
Requis
- idea (positionnel) : Votre concept/idée de miniature
Options de Référence de Visage
--face CHEMIN: Spécifiez une image de référence de visage (par défaut :assets/face.jpg)--no-face: N'inclure aucune référence de visage--face-swap: Post-traitez avec Replicate pour échanger avec un vrai visage (nécessite REPLICATE_API_TOKEN)
Style et Références
--style CHEMIN: Image de style de référence pour la miniature - l'IA fait correspondre la mise en page et l'esthétique--ref CHEMIN: Image de référence supplémentaire (peut être utilisée plusieurs fois)
Logo et Sortie
--logo CHEMIN: Logo à superposer sur la miniature--logo-position [bottom-right|bottom-left|top-right|top-left]: Emplacement du logo (par défaut : bottom-right)-o, --output CHEMIN: Répertoire ou chemin de fichier de sortie--variations N: Nombre de variantes à générer (par défaut : 3)
Exemples de Miniatures
Basique - 3 variantes avec paramètres par défaut :
uv run thumbnail.py "réaction choquée aux licenciements massifs chez Google"
Avec référence de style :
uv run thumbnail.py "ma nouvelle idée de vidéo" --style ./miniature-existante.jpg --face ./moi.jpg
Avec échange de visage pour une ressemblance exacte :
uv run thumbnail.py "excité à propos de la nouvelle fonctionnalité IA" --face ./moi.jpg --face-swap
Variante unique pour test rapide :
uv run thumbnail.py "idée de test rapide" --variations 1
Répertoire de sortie personnalisé :
uv run thumbnail.py "mon concept vidéo" -o ./dossier-personnalise/
Sans visage (seulement la scène) :
uv run thumbnail.py "code dramatique à l'écran avec erreur" --no-face
Avec superposition de logo :
uv run thumbnail.py "mon concept vidéo" --logo ./assets/logo.png
Configuration de la Référence de Visage
Pour des miniatures cohérentes :
-
Ajoutez votre(s) photo(s) de profil dans le dossier
assets/:video-processor/assets/ ├── face.jpg # Visage par défaut (chargé automatiquement) ├── face-excited.jpg # Expressions alternatives ├── face-shocked.jpg └── logo.png # Logo de la chaîne -
Le script utilise automatiquement
assets/face.jpgs'il existe -
Remplacez avec
--facepour différentes expressions -
Utilisez
--no-facepour ignorer complètement la référence de visage
Références de Style
Le paramètre --style permet de faire correspondre l'esthétique des miniatures existantes :
- Mise en page et composition globales
- Schémas de couleurs et ambiance
- Style du texte (poids de la police, couleurs, emplacement)
- Style et effets d'arrière-plan
Idéal pour maintenir une image de marque cohérente sur la chaîne.
Directives de Marque et Bonnes Pratiques
IMPORTANT : Avant de générer des miniatures, lisez references/brand-guidelines.md pour :
- Utilisation de la couleur bleue de la marque (comme accent, pas de manière dominante)
- Exigences de teinte de peau naturelle (pas de teinte bleue sur le visage)
- Palettes de couleurs équilibrées (mélange de couleurs vives)
- Modèles de mise en évidence du texte (1-2 mots-clés en bleu)
- Directives de composition (mise en page, flux visuel)
- Exemples éprouvés issus de miniatures passées réussies
Ces directives garantissent que les miniatures maintiennent la cohérence de la marque tout en évitant les pièges courants comme la sursaturation ou l'éclairage non naturel.
Échange de Visage pour une Ressemblance Exacte
Les visages générés par IA peuvent ne pas être exacts. Utilisez --face-swap pour le post-traitement :
uv run thumbnail.py "mon idée de vidéo" --face ./moi.jpg --face-swap
Comment ça fonctionne :
- Génère la miniature avec l'IA (en utilisant le visage comme référence pour le positionnement)
- Post-traite avec Replicate pour échanger avec votre vrai visage
Configuration :
- Obtenez un jeton API Replicate sur https://replicate.com/account/api-tokens
- Ajoutez à
.env:REPLICATE_API_TOKEN=r8_votre_jeton_ici - Coût : ~$0.003 par échange de visage (~370 échanges pour 1$)
Spécifications des Miniatures
| Élément | Valeur |
|---|---|
| Résolution | 1920x1080 (1080p) |
| Rapport d'aspect | 16:9 |
| Format | PNG (ou JPG avec --output .jpg) |
| Variantes par défaut | 3 |
| Modèle | Gemini 3 Pro (Nano Banana Pro) par défaut |
Remarques Importantes sur les Miniatures
- Le modèle Gemini supporte les images de référence ; Imagen non
- Coût : ~$0.13 par image avec Gemini 3 Pro
- L'échange de visage ajoute ~$0.003 par miniature
- 3 miniatures avec échange de visage : ~$0.40 au total
- Connexion Internet requise
3. Génération d'Images pour Publications LinkedIn
Commande de Base pour Image LinkedIn
Générez des images et infographies pour publications LinkedIn alimentées par IA :
cd video-processor
uv run linkedin-post.py "votre concept de publication ici"
Comportement par défaut :
- Génère 3 variantes
- Sauvegarde dans :
./output/LinkedIn/[AAAA-MM-JJ]/ - Sortie : fichiers PNG 1200x1200 (format carré LinkedIn)
- Optimisé pour les mises en page d'infographies (pas de visage, fond blanc, design plat)
Paramètres de l'Image LinkedIn
Requis
- idea (positionnel) : Votre concept/idée de publication LinkedIn
Style et Références
--style CHEMIN: Image de style de référence - l'IA fait correspondre la mise en page et l'esthétique--ref CHEMIN: Image de référence supplémentaire (peut être utilisée plusieurs fois)
Logo et Sortie
--logo CHEMIN: Logo à superposer sur l'image--logo-position [bottom-right|bottom-left|top-right|top-left]: Emplacement du logo (par défaut : bottom-right)-o, --output CHEMIN: Répertoire ou chemin de fichier de sortie--variations N: Nombre de variantes à générer (par défaut : 3)
Exemples d'Images LinkedIn
Basique - 3 variantes :
uv run linkedin-post.py "Pyramide de validation IA avec 5 niveaux montrant les responsabilités humain vs agent"
Avec référence de style :
uv run linkedin-post.py "mon concept d'infographie" --style ./infographie-existante.jpg
Variante unique pour test :
uv run linkedin-post.py "test rapide" --variations 1
Répertoire de sortie personnalisé :
uv run linkedin-post.py "mon concept" -o ./dossier-personnalise/
Avec superposition de logo :
uv run linkedin-post.py "mon infographie" --logo ./assets/logo.png
Spécifications des Images LinkedIn
| Élément | Valeur |
|---|---|
| Résolution | 1200x1200 (carré LinkedIn) |
| Rapport d'aspect | 1:1 |
| Format | PNG (ou JPG avec --output .jpg) |
| Variantes par défaut | 3 |
| Modèle | Gemini 3 Pro (Nano Banana Pro) par défaut |
| Style | Infographie professionnelle, sans visage, design plat |
Remarques Importantes sur les Images LinkedIn
- Optimisé pour les infographies professionnelles pour entreprises
- Thème sombre avec esthétique moderne et épurée
- AUCUN visage ou personne inclus (pur style diagramme/infographie)
- Thème de couleur bleue avec dégradés
- Densité d'information plus élevée que les miniatures YouTube
- Coût : ~$0.13 par image avec Gemini 3 Pro
- Connexion Internet requise
4. Génération d'Images Génériques
Commande de Base pour Image Générique
Générez des images alimentées par IA avec des dimensions personnalisées pour toute plateforme :
cd video-processor
uv run image-gen.py "votre concept d'image" --dimensions LARGEURxHAUTEUR
Fonctionnalités clés :
- Dimensions personnalisées (paramètre requis)
- Encapsulation minimale du prompt (flexibilité maximale)
- Supporte les références de style
- Sauvegarde dans :
./output/Images/[AAAA-MM-JJ]/ - Par défaut : 3 variantes
Paramètres de l'Image Générique
Requis
- idea (positionnel) : Votre concept d'image avec les détails complets du prompt
--dimensions LARGEURxHAUTEUR: Dimensions de l'image (ex. : 1080x1080, 1200x675)
Style et Références
--style CHEMIN: Image de style de référence - l'IA fait correspondre l'esthétique--ref CHEMIN: Image de référence supplémentaire (peut être utilisée plusieurs fois)
Logo et Sortie
--logo CHEMIN: Logo à superposer sur l'image--logo-position [bottom-right|bottom-left|top-right|top-left]: Emplacement du logo (par défaut : bottom-right)-o, --output CHEMIN: Répertoire ou chemin de fichier de sortie--variations N: Nombre de variantes à générer (par défaut : 3)
Exemples d'Images Génériques
Publication carrée Instagram :
uv run image-gen.py "photo de produit minimaliste sur fond blanc" --dimensions 1080x1080
Story Instagram :
uv run image-gen.py "design de citation motivante verticale" --dimensions 1080x1920
Image pour publication Twitter :
uv run image-gen.py "graphique d'annonce tech avec thème bleu" --dimensions 1200x675
Photo de couverture Facebook :
uv run image-gen.py "en-tête professionnel pour entreprise" --dimensions 820x312
Avec référence de style :
uv run image-gen.py "mon concept" --dimensions 1200x1200 --style ./reference.jpg
Référence des Dimensions Courantes
| Plateforme | Taille | Rapport d'aspect | Commande |
|---|---|---|---|
| Miniature YouTube | 1920x1080 | 16:9 | Utilisez thumbnail.py à la place |
| Carré LinkedIn | 1200x1200 | 1:1 | Utilisez linkedin-post.py à la place |
| Carré Instagram | 1080x1080 | 1:1 | --dimensions 1080x1080 |
| Story Instagram | 1080x1920 | 9:16 | --dimensions 1080x1920 |
| Publication Twitter | 1200x675 | 16:9 | --dimensions 1200x675 |
| Publication Facebook | 1200x630 | 1.91:1 | --dimensions 1200x630 |
| Épingle Pinterest | 1000x1500 | 2:3 | --dimensions 1000x1500 |
Remarques Importantes sur les Images Génériques
- Utilisation recommandée lorsque les autres outils ne correspondent pas à la plateforme
- Flexibilité maximale avec un contrôle total des dimensions et du prompt
- Idéal pour créer des actifs visuels uniques pour le contenu des réseaux sociaux
- Supporte plusieurs images de référence pour une esthétique cohérente
- Coût : ~$0.13 par image avec Gemini 3 Pro
- Connexion Internet requise
Variables d'Environnement
Créez un fichier .env dans le dossier video-processor/ avec les clés suivantes :
OPENAI_API_KEY=sk-votre_clé_ici
GEMINI_API_KEY=votre_clé_gemini_ici
REPLICATE_API_TOKEN=r8-votre_jeton_ici # Optionnel, pour l'échange de visage
Structure du Projet
video-processor/
├── video-processor/ # Code source et scripts
│ ├── transcribe.py # Script de transcription
│ ├── chapters.py # Script de génération de chapitres
│ ├── thumbnail.py # Script de génération de miniatures
│ ├── linkedin-post.py # Script de génération d'images LinkedIn
│ ├── image-gen.py # Script de génération d'images générique
│ └── ...
├── assets/ # Fichiers de référence (visages, logos)
│ ├── face.jpg
│ ├── face-excited.jpg
│ ├── face-shocked.jpg
│ └── logo.png
├── references/ # Documentation supplémentaire
│ └── brand-guidelines.md
├── output/ # Images générées
│ ├── Thumbnails/
│ ├── LinkedIn/
│ └── Images/
├── pyproject.toml
└── .env # Clés API
Notes de Coût
| Service | Coût |
|---|---|
| Whisper API (transcription) | ~$0.006/minute audio |
| Gemini 3 Pro (images) | ~$0.13/image |
| Replicate (échange de visage) | ~$0.003/échange |
| Total pour 3 miniatures + échange de visage | ~$0.40 |