Analyseur vidéo Gemini
Analysez des vidéos de manière native via l'API multimodale de Google Gemini. Aucune extraction d'images nécessaire — Gemini traite la vidéo à 1 image par seconde avec une compréhension complète du mouvement, de l'audio et du visuel.
Démarrage rapide
# Analyser une vidéo avec une invite par défaut (description complète)
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/analyze.py /chemin/vers/ma_video.mp4
# Poser une question spécifique
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/analyze.py /chemin/vers/ma_video.mp4 "Quel texte est visible à l'écran ?"
# Gérer les fichiers téléversés
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/manage_files.py list
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/manage_files.py cleanup
Formats pris en charge
MP4, AVI, MOV, MKV, WebM, FLV, MPEG, MPG, WMV, 3GP — jusqu'à 2 Go par fichier.
Fonctionnement
- La vidéo est téléversée sur l'API Files de Google (temporaire, suppression automatique après 48h)
- Gemini traite à 1 image/seconde — comprend le mouvement, les transitions, le contexte audio
- Le modèle génère une réponse en fonction de votre invite
- Bien meilleur que l'extraction d'images pour comprendre le contenu temporel
Cas d'utilisation
| Tâche | Exemple d'invite |
|---|---|
| Description générale | (par défaut — aucune invite nécessaire) |
| Extraction d'interface utilisateur/texte | "Quels sont les textes et éléments d'interface visibles ?" |
| Résumé de tutoriel | "Résumez les étapes présentées dans ce tutoriel" |
| Rapport de bug à partir d'une vidéo | "Décrivez ce qui a mal fonctionné dans cet enregistrement d'écran" |
| Notes de réunion | "Résumez les points clés abordés" |
| Comparaison de contenu | Téléversez 2 vidéos, demandez les différences |
Configuration
Définissez GOOGLE_AI_API_KEY dans votre environnement ou fichier .env. Obtenez une clé gratuite sur aistudio.google.com.
Modèle par défaut : gemini-2.5-flash (rapide, économique, excellente vision). Remplacez avec --model gemini-2.5-pro pour une analyse complexe.
Référence API
Voir references/gemini-files-api.md pour les limites de téléversement, les détails de traitement et les options avancées.