Actie: AI-video analyseren

Met de workflowactie AI-video analyseren (AI Analyze Video) laat je AI een video bekijken en analyseren. In dit artikel lees je hoe je de actie instelt, welke videolinks werken en hoe je de uitvoer in vervolgstappen gebruikt. Je vindt ook voorbeelden en antwoorden op veelgestelde vragen.

Let op: dit is een premium actie. Voor elke uitvoering betaal je gebruikskosten, die van je opwaardeertegoed afgaan.

Wat is de actie AI-video analyseren?

Deze actie vind je onder AI-acties (AI Actions) in workflows. De actie gebruikt een Google Gemini-model om een video te bekijken en een antwoord in tekst terug te geven. Je geeft een video-URL en een prompt op waarin je beschrijft waar de AI op moet letten. De analyse kun je daarna gebruiken in volgende acties.

Het model bekijkt de beelden en luistert naar de audio. Zo kun je video's samenvatten, scènes beschrijven, gesproken tekst of tekst op het scherm ophalen en met tijdstempels laten aangeven wat er in een video te zien is.

Voordelen

  • Videosamenvattingen: maak van een lange video een paar opsommingstekens die je team of je contacten snel kunnen lezen.
  • Beeld en spraak begrijpen: het model gebruikt zowel beeld als geluid en kan beschrijven wat er gebeurt en wordt gezegd.
  • Tijdstempels: vraag om tijdstempels om terug te vinden wanneer een product, persoon of onderwerp verschijnt.
  • Ondersteuning voor YouTube-links: analyseer openbare YouTube-video's, waaronder youtu.be- en Shorts-links, en directe links naar videobestanden.
  • Flexibele prompts: bepaal met je prompt waar de AI op let en hoe het antwoord eruitziet.
  • Combineren met videogeneratie: gebruik de actie na AI-video genereren (AI Video Generation) om een gemaakte video te beschrijven of te controleren.

Instellingen van de actie

Veld Beschrijving
Actienaam (Action Name) Een zelfgekozen naam waarmee je de actie herkent in de workflowbouwer en uitvoeringslogboeken.
Model Het Google Gemini-model voor de analyse: Gemini 3.8 Flash (standaard) of Gemini 3.5 Flash Lite.
Video Verplicht. Een openbare HTTPS-URL van de video: een openbare YouTube-link of een directe link naar een videobestand in MP4, MOV, WebM, MPEG, FLV, WMV of 3GP. Je kunt de URL typen of ophalen uit een vorige stap of een aangepaste waarde.
Analyseprompt (Analysis Prompt) Verplicht. Instructies over waar de AI op moet letten en hoe het antwoord eruit moet zien. Je kunt aangepaste waarden gebruiken voor dynamische prompts.

De actie instellen

Stap 1: Voeg de actie toe

  1. Ga naar Automatisering (Automation) → Workflows.
  2. Maak een nieuwe workflow of bewerk een bestaande workflow.
  3. Klik op het +-pictogram om een actie toe te voegen. Zoek naar ‘analyze video’ of open AI-acties en selecteer AI-video analyseren.
  4. Geef de actie een duidelijke naam, zodat je die makkelijk herkent in de workflowbouwer.

Stap 2: Selecteer het model

Kies het Gemini-model voor de analyse. Je kunt kiezen uit:

  • Gemini 3.8 Flash (standaard)
  • Gemini 3.5 Flash Lite

Weet je niet welk model je wilt gebruiken? Test dezelfde video en prompt met beide modellen en vergelijk de antwoorden voordat je de workflow publiceert.

Stap 3: Voeg de video-URL toe

Vul de URL in van de video die je wilt analyseren. Je kunt de link typen of plakken, of op het tagpictogram klikken om een waarde in te voegen:

  • Vorige stappen (Previous steps): een video-URL uit een eerdere stap in de workflow, bijvoorbeeld de uitvoer van AI-video genereren of een waarde uit een inkomende webhook.
  • Aangepaste waarden (Custom Values): een contactveld of andere aangepaste waarde met een video-URL.

De URL moet een openbare HTTPS-link zijn. Beweeg je muis over het informatiepictogram naast het veld om de ondersteunde bestandsformaten te bekijken.

Stap 4: Schrijf de analyseprompt

Schrijf een prompt waarin je aangeeft waar de AI op moet letten en hoe het antwoord eruit moet zien. Hoe specifieker je prompt, hoe bruikbaarder de uitvoer.

Voorbeelden:

  • Vat de belangrijkste gebeurtenissen in deze video samen in 3 opsommingstekens.
  • Maak een lijst van de getoonde producten, met tijdstempels.
  • Schrijf op wat de spreker zegt over prijzen.
  • Lees de tekst op het scherm en geef die terug als lijst.

Het promptveld ondersteunt aangepaste waarden. Zo kun je de prompt dynamisch samenstellen met contactvelden, webhookgegevens of uitvoer uit eerdere acties.

Stap 5: Sla de actie op

Klik op Actie opslaan (Save action). Zodra de workflow is uitgevoerd, is de analyse als variabele beschikbaar in alle volgende acties.

Stap 6: Test de actie (optioneel)

Je kunt de actie rechtstreeks vanuit de workflowbouwer testen en het antwoord van de AI bekijken voordat je de workflow publiceert. De test gebruikt gegevens van je trigger, dus test eerst de trigger.

  1. Open het tabblad Testen (Test). Bij Invoer (Input) zie je welke waarden de actie gebruikt, zoals de video-URL en de prompt.
  2. Klik op Actie testen (Test Action) of op Opnieuw testen (Retest) als de actie al eerder is getest.
  3. Na afloop zie je het resultaat bij Uitvoer (Output). Klik op Antwoord (Response) om het volledige antwoord van de AI te lezen.

Bij lange video's kan een test even duren. In een test duurde de analyse van een YouTube-video van 10 minuten ongeveer 30 seconden.

In het voorbeeld hieronder gebruiken we de openbare YouTube-korte film Big Buck Bunny. De prompt vraagt om een samenvatting in 3 opsommingstekens.

Vereisten voor de video-URL

Het AI-model haalt de video rechtstreeks op via de URL. De URL moet openbaar zijn: iedereen moet de video kunnen openen zonder in te loggen.

Videolink Werkt? Toelichting
Openbare YouTube-video (youtube.com/watch, youtu.be en Shorts-links) Ja Plak de gewone deellink. De video moet openbaar zijn.
Directe link naar een videobestand, bijvoorbeeld .mp4, .webm of .mov Ja De link moet het bestand zelf openen of downloaden zonder dat je hoeft in te loggen.
Video uit de Mediabibliotheek (Media Storage), ook video's die met AI-video genereren zijn gemaakt Ja
Paginaverwijzingen van Vimeo, TikTok en andere videoplatforms Nee Deze websites blokkeren automatische toegang, waardoor het model de video niet kan ophalen.
Links waarvoor je moet inloggen, een wachtwoord nodig hebt of toestemming moet krijgen Nee Bijvoorbeeld een privélink naar een clouddienst of een verlopen ondertekende link.
Een webpagina die geen video is Nee Gebruik een link naar de video zelf, niet naar een pagina waarop de video staat.

Tip: open de URL in een privé- of incognitovenster. Als de video zonder inloggen afspeelt of wordt gedownload, kan de actie de video meestal bereiken. Gebruik voor andere videoplatforms dan YouTube een directe bestandslink in plaats van een paginalink.

Belangrijk: gebruik altijd een link naar een echte video. Bij een gewone webpagina kan de actie toch een antwoord geven, maar dat antwoord beschrijft dan geen echte video.

Veelvoorkomende fouten

Foutmelding Betekenis Oplossing
Cannot fetch content from the provided URL. The URL is blocked by robots.txt rules. De website staat automatische toegang niet toe. Paginaverwijzingen van Vimeo en TikTok geven deze fout. Gebruik een openbare YouTube-link of een directe link naar een videobestand.
Cannot fetch content from the provided URL. Please ensure the URL is valid and accessible. Status: URL_ERROR_ERROR_OTHER De URL kon niet worden geopend, bijvoorbeeld omdat je moet inloggen of omdat de URL niet meer bestaat. Open de URL in een privévenster en controleer of de video laadt.
Cannot fetch content from the provided URL. Status: URL_REJECTED_REJECTED_SCHEDULE_TIME_OVER_DEADLINE Het ophalen van de video duurde te lang. Voer de actie opnieuw uit. Blijft de fout optreden, gebruik dan een kleiner bestand of een YouTube-link.

De uitvoer in volgende acties gebruiken

Na de uitvoering is het antwoord via de kiezer voor aangepaste waarden beschikbaar in volgende acties. Open de kiezer, ga naar Vorige stappen, selecteer AI-video analyseren, kies de betreffende stap en selecteer Antwoord.

De uitvoer is een tekstwaarde met het antwoord op je prompt: bijvoorbeeld een samenvatting, transcript, lijst met tijdstempels of een ander gevraagd resultaat. Het antwoord kan Markdown-opmaak bevatten, zoals koppen (### ) en opsommingstekens (* ). Heb je platte tekst nodig? Vraag daar dan om in je prompt, bijvoorbeeld: ‘Geef platte tekst terug zonder Markdown.’

Je kunt de uitvoer gebruiken op plekken waar een tekstwaarde wordt geaccepteerd. Sla het antwoord bijvoorbeeld op in een aangepast veld van een contact, neem het op in een e-mail of sms, stuur het naar een uitgaande webhook of geef het door aan een andere AI-actie voor verdere verwerking.

Voorbeelden

1. Video's van mogelijke klanten samenvatten

Situatie: mogelijke klanten sturen je een YouTube-link naar een rondleiding door een woning, een productdemo of een probleem waarbij ze hulp nodig hebben. Je team wil een korte samenvatting bij het contact bewaren, zonder elke video te bekijken.

Instelling:

  • Trigger: Formulier verzonden (Form Submitted), met een veld voor de videolink.
  • Actie 1: AI-video analyseren, gebruik de video uit het formulierveld. Prompt: ‘Vat deze video samen in 3 opsommingstekens.’
  • Actie 2: Contactveld bijwerken (Update Contact Field), sla het antwoord op in een aangepast veld om het later te bekijken.

2. Een gegenereerde video controleren

Situatie: je workflow maakt een video met AI-video genereren. Je wilt controleren wat er is gemaakt voordat de video naar een klant gaat.

Instelling:

  • Actie 1: AI-video genereren, maak de video op basis van je prompt.
  • Actie 2: AI-video analyseren, gebruik de video-URL uit de vorige actie. Prompt: ‘Beschrijf deze video. Staat er een koffiekopje op een houten tafel? Antwoord eerst met Ja of Nee.’
  • Actie 3: Als/anders (If/Else) of Interne melding (Internal Notification), bepaal de volgende stap op basis van het antwoord of stuur het naar je team voor een controle voordat je de video verstuurt.

3. Aantekeningen maken van webinaropnames

Situatie: opnames komen vanuit een extern systeem binnen als directe videolinks. Je wilt voor elke opname aantekeningen, hoofdpunten en tijdstempels maken.

Instelling:

  • Trigger: Inkomende webhook (Inbound Webhook), met de video-URL.
  • Actie 1: AI-video analyseren, prompt: ‘Maak een lijst van de belangrijkste besproken onderwerpen, elk met een tijdstempel.’
  • Actie 2: Uitgaande webhook (Outbound Webhook) of E-mail versturen (Send Email), stuur de aantekeningen naar je contentteam.

Meer ideeën

  • Klantverhalen bekijken: haal de sterkste citaten uit video's met ervaringen van klanten.
  • Inzendingen controleren: controleer of een ingestuurde video laat zien wat je hebt gevraagd, zoals een afgeronde installatie of een unboxing.
  • Video's categoriseren: vraag het model om een korte lijst met onderwerpen of categorieën en gebruik de uitvoer om contacten een tag te geven of de workflow naar een passende stap te sturen.
  • Transcripties maken: vraag om een uitgeschreven versie van wat de spreker zegt en stuur die naar je team of sla die op bij het contact.

Tips voor betere resultaten

  • Wees specifiek over de gewenste uitvoer. ‘Geef alleen de productnamen terug, één per regel’ levert een bruikbare waarde op. ‘Vertel me over deze video’ levert een lange alinea op.
  • Vraag om tijdstempels als je een moment in de video wilt terugvinden.
  • Gebruik openbare YouTube-links of directe bestandslinks. Paginaverwijzingen van andere videoplatforms worden vaak geblokkeerd.
  • Vraag om een vaste indeling als je de uitvoer wilt opslaan in een aangepast veld of gebruiken in een als/anders-tak.
  • Test met een paar echte video's voordat je de workflow op grote schaal gebruikt.

Veelgestelde vragen

Antwoord: ja. Openbare YouTube-video's werken, inclusief youtube.com/watch, youtu.be en YouTube Shorts-links. Plak de gewone deellink.

V: Kan ik elke openbare video-URL gebruiken?

Antwoord: nee. Openbare YouTube-links en directe links naar videobestanden werken. Paginaverwijzingen van platforms zoals Vimeo en TikTok werken niet, omdat deze websites automatische toegang blokkeren. Gebruik voor die platforms een directe bestandslink als die beschikbaar is.

V: Welke videoformaten worden ondersteund?

Antwoord: MP4, MOV, WebM, MPEG, FLV, WMV en 3GP.

V: Wat gebeurt er als je moet inloggen om de video te bekijken?

Antwoord: de actie mislukt. Het AI-model haalt de video rechtstreeks op via de URL. De video moet dus openbaar toegankelijk zijn, zonder inlog, token of toestemmingscontrole. Open de URL in een privévenster om te controleren of iedereen de video kan laden.

V: Luistert de AI ook naar de audio?

Antwoord: ja. Het model gebruikt zowel beeld als geluid. Je kunt dus vragen wat er wordt gezegd en wat er te zien is.

V: Hoe lang mag de video zijn?

Antwoord: in een test werkte een YouTube-video van 10 minuten; de analyse duurde ongeveer 30 seconden.

V: Welk model moet ik kiezen?

Antwoord: er zijn twee Gemini-modellen beschikbaar: Gemini 3.8 Flash (standaard) en Gemini 3.5 Flash Lite. Weet je niet welk model je wilt gebruiken? Test dezelfde video en prompt met beide modellen en vergelijk de antwoorden voordat je de workflow publiceert.

V: Welke indeling heeft de uitvoer?

Antwoord: de uitvoer is een tekstwaarde met de naam Antwoord. Deze kan Markdown-opmaak bevatten, zoals koppen en opsommingstekens. Vraag in je prompt om platte tekst als je die nodig hebt.

V: Waarom is de actie mislukt met een time-outfout?

Antwoord: het ophalen van de video duurde te lang. Voer de actie opnieuw uit. Blijft de fout optreden, gebruik dan een kleiner bestand of een YouTube-link.

V: Kan ik deze actie combineren met AI-video genereren?

Antwoord: ja. Voeg AI-video analyseren toe na AI-video genereren en geef de gegenereerde video-URL door. Zo kun je de video beschrijven of controleren voordat je die verder verstuurt.

V: Kan ik meerdere video's in één actie analyseren?

Antwoord: elke actie AI-video analyseren verwerkt één video-URL. Wil je meerdere video's analyseren in een workflow? Voeg dan voor elke video een aparte actie toe en verwijs in de volgende stappen afzonderlijk naar de uitvoer van elke actie.

Heeft dit je vraag beantwoord? Bedankt voor de feedback! Er was een probleem bij het versturen van je feedback. Probeer later nog eens.