Questa sezione spiega come effettuare la richiesta con un file. Con un URL il procedimento è simile: la differenza principale è l’endpoint da chiamare al passo 1.
Linee guida per l’invio
L’analisi di un video prevede l’elaborazione del video per estrarne frame specifici. Per questo le linee guida da seguire sono simili a quelle per le immagini:- Invia al sistema il video più “vicino” alla fonte: ad esempio, non inviare il video di una foto per analizzare la foto, né un video ripreso da un altro video.
- Per i video presi dai social, i risultati più accurati si ottengono inviando video senza testi sovrapposti né le modifiche tipiche della condivisione sui social.
- Se il video è disponibile da altre fonti, evita di inviare link ai social, a causa della post-elaborazione applicata dalle varie piattaforme.
Scelta della strategia di estrazione dei frame
Solo per i video è necessario scegliere una strategia di estrazione dei frame, che verranno poi analizzati dai modelli di rilevamento. Di seguito sono descritte le strategie di estrazione dei frame:A intervalli regolari
Con questa modalità vengono estratti N frame (in base al “Numero massimo di frame” scelto), equamente distribuiti lungo la durata del video. Per attivarla devi aggiungere i seguenti parametri:frames indica il numero minimo di frame da estrarre. Puoi scegliere tra 5, 10 e 30. Un numero maggiore di frame analizzati corrisponde a un numero maggiore di crediti usati per l’analisi.
Keyframe
- Keyframe - Default: con questa modalità vengono estratti fino a N iframe. Questi frame rappresentano cambi di scena improvvisi nel video e sono quindi potenzialmente interessanti per analizzare scene diverse.
- Keyframe - Color: con questa modalità vengono estratti fino a N frame che rappresentano il frame “medio” di una scena, calcolato in base ai colori dell’immagine.
- Keyframe - Flow: con questa modalità vengono estratti fino a N frame che rappresentano il frame “più statico” di una scena, calcolato rispetto al frame precedente della scena.
frames indica il numero minimo di frame da estrarre. Puoi scegliere tra 5, 10 e 30. Un numero maggiore di frame analizzati corrisponde a un numero maggiore di crediti usati per l’analisi.
Volti
Con questa modalità il sistema cerca i frame che contengono almeno un volto: partendo dal campionamento a intervalli regolari, cerca nel video i frame con volti fino a raggiungere il numero di frame da analizzare. È la strategia consigliata per rilevare face swap e morphing, insieme awith_morphing=true.
- È un’alternativa ai keyframe: con
ensure_face_per_frame=true,key_framesekey_frames_methodvengono ignorati. - La ricerca ha un limite di tempo: nei video in cui i volti sono rari o assenti potrebbero essere analizzati meno frame. I frame non analizzati vengono rimborsati al termine dell’analisi.
- La ricerca può aumentare il tempo di elaborazione e, a seconda del tuo piano tariffario, il costo di ogni frame.
L’estrazione dei volti è una funzionalità del piano tariffario: se il tuo piano non la include,
ensure_face_per_frame viene ignorato e il video viene analizzato con le altre strategie.Momenti specifici
Se sai già quali momenti del video sono rilevanti (ad es. i secondi in cui compare un volto o inizia una scena sospetta), puoi chiedere al sistema di analizzare esattamente quei momenti: viene estratto un frame per ogni timecode indicato.- I timecode sono separati da virgole e nel formato
HH:MM:SS.mmm(ore, minuti, secondi e millisecondi), misurati dall’inizio del video. I duplicati vengono contati una sola volta. - Quando è presente
frames_timestamps, ha la precedenza sulle altre strategie:frames,key_frames,key_frames_methodeensure_face_per_framevengono ignorati. - Viene addebitato un frame per ogni timecode distinto. Puoi indicare fino a 30 timecode se il tuo piano tariffario ti permette di scegliere il numero di frame, altrimenti fino al numero di frame predefinito (10).
- I timecode oltre la fine del video vengono saltati; se nessuno cade all’interno del video, la classificazione termina con un errore.
with_audio=true: con audio_timestamps il sistema analizza un breve segmento audio centrato su ogni timecode indicato, invece di segmenti distribuiti su tutta la traccia. I timecode abbastanza vicini da cadere nello stesso segmento vengono analizzati insieme, e viene addebitato un segmento audio per ogni timecode distinto (i segmenti non prodotti vengono rimborsati al termine dell’analisi). Puoi indicare fino a 30 timecode audio se il tuo piano tariffario ti permette di scegliere il numero di segmenti audio, altrimenti fino a 5.
I momenti specifici sono una funzionalità del piano tariffario, attivata separatamente per i frame e per l’audio: se il tuo piano non li include,
frames_timestamps e audio_timestamps vengono ignorati. I timecode non validi o in numero superiore al consentito vengono rifiutati con un errore 400.Invia un video tramite l’API
Per classificare un video, effettua una richiesta POST a/api/classification_video con i parametri richiesti (per i dettagli sui parametri consulta la sezione Riferimento API).
Recupera i risultati
Usa l’identificativo ricevuto per recuperare i risultati della classificazione con una richiesta GET a/api/classification_video/{identifier} (per i dettagli su come strutturare la richiesta consulta la sezione Riferimento API).
La classificazione potrebbe non essere ancora terminata! Se non è ancora completa, continua a inviare la richiesta GET finché il risultato non è disponibile.
Smart Full Analysis
La Smart Full Analysis è disponibile anche per i video: ogni frame analizzato viene suddiviso in una selezione mirata di ritagli ad alto valore, scelti da un algoritmo di scoring proprietario, che vengono classificati dal modello più avanzato della famiglia Revelio e combinati nel verdetto del frame.Come per le immagini, la Smart Full Analysis è una versione avanzata e intelligente dell’analisi completa standard e della heatmap: quando è abilitata, le sostituisce per ogni frame analizzato.
with_smart_analysis=true:
Se la Smart Full Analysis non è inclusa nel tuo piano tariffario, il parametro
with_smart_analysis viene ignorato e il video viene analizzato con lo scope standard.XAI (eXplainable AI)
Non solo un verdetto. Scopri cosa ha osservato l’intelligenza artificiale per arrivare alla sua decisione. La XAI – eXplainable AI è disponibile anche per i video: quando è abilitata, viene applicata a ogni frame analizzato. Per ogni frame, i modelli Revelio non si limitano a restituire un verdetto, ma anche le informazioni sui punti di attenzione che hanno caratterizzato la classificazione, trasformate in tre strumenti complementari:- Attention Map: una rappresentazione visiva sovrapposta al frame, che evidenzia le aree su cui il modello si è concentrato di più;
- Attention Graph: un grafico che mostra l’andamento e i picchi dell’attenzione del modello;
- Spiegazione AI: una descrizione in linguaggio naturale delle regioni che hanno ricevuto più attenzione, disponibile in più lingue.
Abilita la XAI tramite API
La XAI è controllata dagli stessi parametri usati per le immagini, disponibili nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL:
Se la XAI è inclusa nel tuo piano tariffario, puoi abilitarla in questo modo:
Se la XAI non è inclusa nel tuo piano tariffario, il parametro
with_xai viene ignorato e il video viene analizzato senza XAI.Mappe XAI e spiegazioni nei risultati
Come per le immagini, leexplanations elencano ogni mappa XAI di ciascun modello con la sua spiegazione AI, e sono restituite nei risultati per modello di ogni frame analizzato (results.images[].results[].explanations), con lo stesso formato usato per le immagini. Le spiegazioni AI sono risultati differiti, prodotti dopo l’analisi principale del video: ogni frame analizzato in results.images ha il proprio deferred_status, e description è null finché la spiegazione della mappa non è disponibile, quando le spiegazioni AI non sono state richieste o quando non è stato possibile generare la spiegazione.
Scarica Attention Map e Attention Graph
L’Attention Map e l’Attention Graph di ogni frame analizzato possono essere scaricati con l’endpoint per scaricare le mappe XAI, come per le immagini, usando l’identifier del frame in results.images:
Linee guida per interpretare i risultati
I risultati del video contengono sia i verdetti globali sia il risultato dei singoli frame analizzati. Ti consigliamo di consultare come interpretare i risultati delle immagini.Heatmap sui video
Per le heatmap sui video valgono le stesse considerazioni fatte per le immagini. L’unica differenza è che per analizzare la heatmap devi fare clic su Frame e analizzare la heatmap di ogni singolo frame.Vedi anche
Classifica un'immagine
Avvia la classificazione di un’immagine e scopri se è reale o generata artificialmente!
Classifica un audio vocale
Scopri come avviare la classificazione di un audio vocale e capire se è autentico o generato artificialmente