Vai al contenuto principale
Classifica un video

Autorizzazioni

X-Api-Key
string
header
obbligatorio

La tua API key.

Intestazioni

Accept
enum<string>

Tipo di contenuto della risposta. Valori supportati: application/json, text/plain.

Opzioni disponibili:
application/json,
text/plain

Corpo

multipart/form-data
video
file
obbligatorio

Il video da classificare. Formati supportati: qualsiasi formato video (MP4, AVI, MOV, ecc.). Tipi MIME: qualsiasi tipo MIME che inizia con 'video/' (ad es. video/mp4, video/avi, video/quicktime). Dimensione massima del file: 50MB.

ref_id
string

ID di riferimento facoltativo da associare alla richiesta di classificazione.

frames
enum<integer>

Scegli di classificare al massimo 5, 10 o 30 frame.

Opzioni disponibili:
5,
10,
30
key_frames
boolean

Se impostato a true, estrae i keyframe e li usa per la classificazione al posto di immagini a distanza di tempo fissa. I keyframe estratti possono essere meno dei frames richiesti. Ignorato quando è presente ensure_face_per_frame o frames_timestamps.

key_frames_method
enum<string>

Algoritmo di identificazione dei keyframe. I valori possibili sono iframes (predefinito), flow e color.

  • iframes : estrae gli iframe del video;
  • color : restituisce il frame medio, in base al colore, di ogni sequenza di inquadratura. Le sequenze di inquadratura sono gruppi di frame che iniziano con un iframe;
  • flow : restituisce il frame più statico rispetto al frame precedente di ogni sequenza di inquadratura.
Opzioni disponibili:
iframes,
flow,
color
with_tampering
boolean

Impostalo a true se vuoi analizzare anche i segni di manomissione o manipolazione dell'immagine effettuate senza l'aiuto di un'IA generativa.

with_morphing
boolean

Impostalo a true se vuoi analizzare anche i volti delle persone nell'immagine con il morphing.

with_audio
boolean

[BETA] Impostalo a true se vuoi analizzare anche la traccia audio del video. Per usare questa opzione deve essere abilitata nel tuo piano tariffario.

with_smart_analysis
boolean

Impostalo a true per attivare la Smart Full Analysis su ogni frame analizzato: un algoritmo di scoring proprietario seleziona le aree più informative del frame, che vengono classificate come ritagli separati dal modello più avanzato della famiglia Revelio e poi combinate in un verdetto complessivo. Essendo una versione avanzata e smart di entrambe, sostituisce l'analisi completa standard e l'analisi con heatmap dei frame. Per usarla deve essere abilitata nel tuo piano tariffario, altrimenti il parametro viene ignorato. Consulta Smart Full Analysis per i dettagli.

webhook_url
string

Se indicato, il risultato della classificazione viene inviato automaticamente anche all'URL inserito. Altrimenti il risultato si ottiene tramite polling dell'endpoint relativo. Tieni presente che per usare un URL di callback del webhook devi richiedere un'abilitazione specifica, altrimenti il parametro viene ignorato. Inoltre il sistema può mettere in cache i risultati delle analisi di invii ripetuti, cioè invii dello stesso file con le stesse opzioni: in questo caso il webhook non viene chiamato e i risultati sono accessibili solo tramite polling dell'endpoint relativo.

with_xai
boolean

Impostalo a true per attivare lo scope XAI – eXplainable AI: oltre al verdetto, i modelli Revelio restituiscono informazioni sulle aree di ogni frame analizzato su cui si sono concentrati durante la classificazione (attention map e attention graph). XAI viene applicato a ogni frame analizzato. Per usarlo deve essere abilitato nel tuo piano tariffario, altrimenti il parametro viene ignorato. Consulta XAI – eXplainable AI per i dettagli. Avviso sul trasferimento dei dati: attivando questa funzionalità, i dati delle tue immagini vengono trasferiti alla nostra infrastruttura cloud nell'UE per l'inferenza dei modelli.

with_llm_xai
boolean

Impostalo a true, insieme a with_xai, per ottenere anche le spiegazioni AI: una descrizione in linguaggio naturale delle regioni che hanno ricevuto più attenzione, restituita nel campo description delle explanations dei risultati per modello quando i risultati differiti sono pronti. Le spiegazioni vengono prodotte per ogni frame analizzato. Viene ignorato se with_xai non è attivo. Se XAI è incluso nel tuo piano tariffario ma le spiegazioni AI no, una richiesta con with_llm_xai=true viene rifiutata con un errore 403. I crediti delle spiegazioni che non è possibile generare vengono rimborsati. Le spiegazioni AI sono generate con modelli non sviluppati da identifAI.

llm_xai_language
enum<string>

Lingua delle spiegazioni AI (senza distinzione tra maiuscole e minuscole). Se omessa, viene usata la lingua predefinita del tuo piano tariffario. Viene applicata solo insieme a with_llm_xai; un valore non supportato viene rifiutato con un errore 400.

Opzioni disponibili:
english,
italian,
spanish,
german
deferred_webhook_url
string

Se indicato, l'URL viene notificato una sola volta quando i risultati differiti dell'invio sono completi (ad es. le spiegazioni testuali delle mappe XAI e della heatmap), dopo i risultati principali inviati a webhook_url. La notifica contiene l'evento submission.deferred.completed: consulta Risultati differiti per il payload. Valgono la stessa abilitazione, le stesse restrizioni di dominio e la stessa autenticazione di webhook_url. La consegna è at least once: deduplica per identifier, e tieni presente che una notifica expired può essere seguita da una seconda con l'esito reale, che la sostituisce. Se omesso o vuoto, non viene inviata alcuna notifica dei risultati differiti.

no_cache
boolean

Impostalo a true per obbligare il sistema a rielaborare l'immagine anche se è già stata inviata con le stesse opzioni. Questo può comportare costi aggiuntivi.

prevent_c2pa_forces
boolean

Se true, la firma C2PA non forza l'origine ad artificiale. Se false o non definito, la firma C2PA forza l'origine ad artificiale (comportamento attuale).

with_nsfw
boolean

Impostalo a true se vuoi attivare anche il rilevamento dei contenuti NSFW (Not Safe For Work).

ensure_face_per_frame
boolean

[Funzionalità del piano] Impostalo a true per scegliere la strategia di estrazione dei frame con volti: partendo dal campionamento a intervalli regolari, il sistema cerca nel video i frame che contengono almeno un volto, fino al numero di frame da analizzare (frames). Usalo insieme all'opzione with_morphing per rilevare possibili face swap o morphing nel video. È un'alternativa alle altre strategie: quando è attivo, key_frames e key_frames_method vengono ignorati, mentre viene ignorato a sua volta quando è presente frames_timestamps. La ricerca ha un limite di tempo, quindi 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. Questa opzione può aumentare il tempo di elaborazione e, a seconda del tuo piano tariffario, il costo di ogni frame. Per usare questa opzione deve essere abilitata nel tuo piano tariffario, altrimenti il parametro viene ignorato.

frames_timestamps
string

[Funzionalità del piano] Momenti specifici del video da analizzare. Elenco di timecode separati da virgole nel formato HH:MM:SS.mmm, misurati dall'inizio del file (ad es. 00:00:05.000,00:01:12.500). Quando è presente, viene estratto esattamente un frame per ogni momento indicato e le altre strategie di estrazione dei frame vengono disattivate: frames, key_frames, key_frames_method e ensure_face_per_frame vengono ignorati. I momenti duplicati vengono contati una sola volta. Puoi indicare fino a 30 momenti se il tuo piano tariffario ti permette di scegliere il numero di frame, altrimenti fino al numero di frame predefinito (10). Viene addebitato un frame per ogni momento distinto. I momenti oltre la fine del video vengono saltati: se nessuno cade all'interno del video, la classificazione termina con un errore. Per usare questa opzione deve essere abilitata nel tuo piano tariffario, altrimenti il parametro viene ignorato.

Esempio:

"00:00:05.000,00:01:12.500"

audio_timestamps
string

[Funzionalità del piano] Momenti specifici della traccia audio del video da analizzare. Elenco di timecode separati da virgole nel formato HH:MM:SS.mmm, misurati dall'inizio del file (ad es. 00:00:05.000,00:01:12.500). Si usa solo insieme a with_audio. Quando è presente, invece di suddividere l'audio in segmenti lungo tutta la sua durata, il sistema analizza un breve segmento audio centrato su ogni momento indicato; i momenti abbastanza vicini da cadere nello stesso segmento vengono analizzati insieme in un unico segmento. I momenti duplicati vengono contati una sola volta. Puoi indicare fino a 30 momenti se il tuo piano tariffario ti permette di scegliere il numero di segmenti audio, altrimenti fino a 5. Viene addebitato un segmento audio per ogni momento distinto: i segmenti non prodotti (momenti raggruppati, momenti oltre la fine dell'audio) vengono rimborsati al termine dell'analisi. Se nessun momento cade all'interno dell'audio, la classificazione termina con un errore. Per usare questa opzione deve essere abilitata nel tuo piano tariffario, altrimenti il parametro viene ignorato.

Esempio:

"00:00:05.000,00:01:12.500"

Risposta

L'identificativo della classificazione. Il formato dipende dall'header Accept.

identifier
string
Esempio:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"