Extract Video Frame

Le node Extract Video Frame extrait une image unique depuis une vidéo, avec des options de sélection de frame, de format de sortie et de redimensionnement.

À quoi sert le node Extract Video Frame ?

Le node Extract Video Frame prend une vidéo et en extrait une seule frame sous forme d’image. Vous pouvez choisir quelle frame extraire : la première, la dernière, à un timestamp précis ou à un pourcentage de la durée de la vidéo.

Cas d’utilisation courants :

• Générer des miniatures à partir de vidéos pour des aperçus de contenu ou des publications sur les réseaux sociaux
• Extraire une frame spécifique d’une vidéo de démonstration produit pour l’utiliser dans la documentation
• Capturer un moment clé d’une vidéo générée par IA pour un traitement d’image ultérieur (Image to Image, Image to Text)
• Créer des images de couverture à partir de contenus vidéo stockés dans Google Drive ou des nodes Static Video

Configuration rapide

Paramètres de configuration

Champs obligatoires

Champs conditionnels

Champs optionnels

Que produit le node en sortie ?

Le node produit un tableau JSON contenant un seul objet image :

[
  {
    "image": "frame_001.png",
    "mimeType": "image/png",
    "frameMode": "timestamp",
    "outputFormat": "png",
    "resolution": "1920x1080",
    "timestamp": "15.2s"
  }
]

L’image de sortie peut aussi être téléchargée directement via le bouton de téléchargement du node.

Exemples d’utilisation

Exemple 1 : Générer une miniature vidéo

Vous avez une vidéo de démonstration produit et souhaitez extraire une frame à la 3e seconde pour l’utiliser comme miniature.

Configuration :

• Frame Mode : Timestamp
• Timestamp : 00:00:03
• Output Format : JPEG
• Resize Mode : Width → 640px

Exemple 2 : Analyser une frame d’une vidéo générée par IA

Vous générez une vidéo avec Image to Video et souhaitez analyser une frame spécifique avec Image to Text.

Workflow :

1. Image to Video — Génère une vidéo à partir d’une image
2. Extract Video Frame — Extrait la dernière frame
3. Image to Text — Analyse la frame extraite avec l’IA

Configuration :

• Frame Mode : Last
• Output Format : PNG
• Resize Mode : None

Exemple 3 : Extraire des frames à différentes positions dans une boucle

Vous souhaitez créer plusieurs miniatures à partir de différentes positions d’une même vidéo.

Workflow :

1. Static Video — Chargez la vidéo source
2. Create List — Définissez les pourcentages : 10, 25, 50, 75, 90
3. Loop — Itérez sur chaque pourcentage
4. Extract Video Frame — Extrait la frame à {{percentage}}% pour chaque itération

Bonnes pratiques

Problèmes courants

Le node rejette mon entrée avec 'only processes one video at a time'

Cause : Le node connecté produit un tableau de vidéos (par ex. Static Video avec plusieurs fichiers, ou une sortie de Loop).

Solution : Extract Video Frame n’accepte qu’une seule vidéo. Utilisez un node Loop en amont pour itérer sur chaque vidéo, ou utilisez un JSON Path Extractor pour sélectionner une vidéo dans le tableau.

La frame extraite est noire ou vide

Cause : Le timestamp ou le pourcentage pointe vers un moment de la vidéo sans contenu visuel (par ex. avant le début du rendu ou après un fondu au noir).

Solution : Essayez un mode de frame différent ou ajustez le timestamp/pourcentage. Utilisez le mode “First” ou “Last” pour vérifier que la vidéo a du contenu visuel, puis affinez la position.

Le curseur de timestamp n'apparaît pas

Cause : La durée de la vidéo n’a pas pu être détectée. Le curseur n’apparaît que lorsque la source est un node Static Video avec une durée connue.

Solution : Vous pouvez toujours saisir le timestamp manuellement au format HH:MM:SS. Le curseur est une fonctionnalité de confort, pas une obligation.

Comment s’intègre-t-il dans un workflow ?

Extract Video Frame est généralement utilisé pour convertir du contenu vidéo en images pour un traitement ultérieur :

graph LR
    Video[Source Vidéo] --> Extract[Extract Video Frame]
    Extract --> Process[Image to Text / Image to Image]

Nodes associés