Vai al contenuto principale

Versione 1.3.2

Più recente2026-11-09

Funzionalità

Introdotto lo scope di analisi XAI – eXplainable AI: oltre al verdetto, i modelli Revelio restituiscono informazioni sulle aree del contenuto su cui si sono concentrati durante la classificazione, trasformate in un’Attention Map, un Attention Graph e una spiegazione AI in linguaggio naturale. La XAI è disponibile per immagini e video (dove viene applicata a ogni frame analizzato); per usarla devi essere abilitato nel tuo piano tariffario. Vedi XAI – eXplainable AI. Avviso sul trasferimento dei dati: abilitando questa funzionalità, i dati delle tue immagini vengono trasferiti alla nostra infrastruttura cloud nell’UE per l’inferenza dei modelli. Le spiegazioni AI sono generate con modelli non sviluppati da identifAI.
  • Aggiunte le opzioni with_xai, with_llm_xai e llm_xai_language nell’API per la classificazione delle immagini, nell’API per la classificazione delle immagini da URL, nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL:
    • with_xai abilita lo scope XAI; se la XAI non è inclusa nel tuo piano tariffario, il parametro viene ignorato;
    • with_llm_xai, insieme a with_xai, abilita anche le spiegazioni AI; se il tuo piano include la XAI ma non le spiegazioni AI, la richiesta viene rifiutata con un errore 403;
    • llm_xai_language imposta la lingua delle spiegazioni AI (english, italian, spanish o german, senza distinzione tra maiuscole e minuscole); un valore non supportato viene rifiutato con un errore 400. Se omesso, viene usata la lingua predefinita del tuo piano tariffario.
  • Aggiunto il campo explanations ai risultati per modello del risultato della classificazione di un’immagine e di ogni frame del risultato della classificazione di un video: elenca ogni mappa XAI prodotta dal modello, con il suo type (attention_map, attention_graph o heatmap), il method XAI e la description in linguaggio naturale. Le mappe sono elencate anche quando le spiegazioni AI non sono state richieste: description è null se la spiegazione non è stata richiesta, non è ancora disponibile o non è stato possibile generarla. I crediti delle spiegazioni AI che non è possibile generare vengono rimborsati.
  • Aggiunta l’API per scaricare una mappa XAI: restituisce l’Attention Map o l’Attention Graph di un’immagine o di un frame di un video, dati il model, il method XAI e il type di mappa. Quando la XAI è combinata con la Smart Full Analysis, la heatmap si scarica comunque con l’endpoint per scaricare la heatmap.
Introdotti i risultati differiti: risultati prodotti dopo quelli principali, senza ritardarli, come le spiegazioni AI delle mappe XAI e della heatmap. Vedi Risultati differiti.
  • Aggiunta l’opzione deferred_webhook_url nelle API di classificazione di immagini, video e audio vocali (anche da URL): l’URL riceve una sola notifica, con l’evento submission.deferred.completed, quando i risultati differiti sono completi. Stessa abilitazione, stesse restrizioni sui domini e stessa autenticazione di webhook_url.
  • Aggiunti deferred_status, deferred_progress e deferred_errors ai risultati della classificazione (e a ogni frame dei video) degli invii con risultati differiti.
  • Anche i webhook configurati nella dashboard possono notificare i risultati differiti.
I risultati principali, il payload del loro webhook e lo status non cambiano.

Versione 1.3.1

2026-11-02

Funzionalità

  • Aggiunta l’opzione with_smart_analysis nell’API per la classificazione delle immagini e nell’API per la classificazione delle immagini da URL: il flag abilita il nuovo scope Smart Full Analysis, ma per usarlo devi essere abilitato nel tuo piano tariffario, altrimenti il parametro viene ignorato. Quando è abilitata, un algoritmo di scoring proprietario seleziona le aree dell’immagine con il maggior contenuto informativo; ogni ritaglio selezionato viene classificato dal modello più avanzato della famiglia Revelio e i singoli risultati vengono combinati in un verdetto complessivo. Essendo una versione avanzata e intelligente di entrambe, la Smart Full Analysis sostituisce l’analisi completa standard e l’analisi con heatmap quando è abilitata: per questo non può essere combinata con with_heatmap, e una richiesta con entrambe le opzioni impostate a true restituisce un errore 422. Vedi Smart Full Analysis per maggiori dettagli.
  • Aggiunta la stessa opzione with_smart_analysis nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL: quando è abilitata, la Smart Full Analysis viene applicata a ogni frame analizzato. Vedi Smart Full Analysis sui video.

Versione 1.3.0

2026-10-19

Funzionalità

Introdotta l’analisi dei momenti specifici: invece di lasciare al sistema la scelta delle parti del media da analizzare, puoi indicare i momenti esatti di interesse di un video e/o della sua traccia audio, oppure di un audio vocale. I momenti vengono passati come elenco di timecode HH:MM:SS.mmm separati da virgole, misurati dall’inizio del file (ad es. 00:00:05.000,00:01:12.500).
  • Frame del video: aggiunta l’opzione frames_timestamps nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL. Viene estratto e analizzato un frame per ogni timecode indicato; l’opzione ha la precedenza sulle strategie di estrazione a intervalli regolari, dei keyframe e dei volti (frames, key_frames, key_frames_method e ensure_face_per_frame vengono ignorati). Vedi Classifica un video.
  • Traccia audio del video: aggiunta l’opzione audio_timestamps nelle stesse API per i video, da usare insieme a with_audio. La traccia audio viene analizzata in brevi segmenti centrati sui timecode indicati, invece che lungo tutta la sua durata. Può essere combinata con frames_timestamps o usata da sola.
  • Voce: aggiunta l’opzione audio_timestamps nell’API per la classificazione degli audio vocali e nell’API per la classificazione degli audio vocali da URL, con lo stesso comportamento. Vedi Classifica un audio vocale.
  • Crediti e limiti: viene addebitato un frame / segmento audio per ogni timecode distinto; i timecode abbastanza vicini da cadere nello stesso segmento audio vengono analizzati insieme e i segmenti non prodotti vengono rimborsati. Sono accettati fino a 30 timecode se il tuo piano tariffario ti permette di scegliere il numero di frame / segmenti audio, altrimenti fino ai valori predefiniti (10 frame, 5 segmenti audio). I timecode non validi o in numero eccessivo vengono rifiutati con un errore 400.
  • Disponibilità: i momenti specifici sono una funzionalità del piano tariffario, attivata separatamente per i frame del video e per l’audio; se il tuo piano non li include, frames_timestamps e audio_timestamps vengono ignorati.

Modifiche

  • Documentato ensure_face_per_frame come strategia di estrazione dei frame con volti (vedi Classifica un video): è una funzionalità del piano tariffario (ignorata se il tuo piano non la include), è un’alternativa ai keyframe (key_frames e key_frames_method vengono ignorati quando è attiva) e viene ignorata quando è presente frames_timestamps. I frame non analizzati perché non sono stati trovati abbastanza volti vengono rimborsati.

Versione 1.2.0

2026-10-12

Funzionalità

  • Aggiunta l’API per la validazione dei media: verifica se un file immagine, video o audio può essere analizzato con le opzioni indicate (tipo e dimensione del file, integrità, risoluzione minima richiesta dai modelli selezionati) senza inviarlo per la classificazione e senza consumare crediti.

Versione 1.1.3

2026-04-09

Funzionalità

  • Aggiunto un campo details nel payload di risposta dell’invio di immagini/video, con maggiori informazioni sui singoli elementi rilevati, estratti e analizzati dal media (i volti trovati nell’immagine/nel frame quando è attiva l’opzione with_morphing).

Versione 1.1.2

2026-03-12

Funzionalità

  • Aggiunto un campo details nel payload di risposta dell’invio di audio, con maggiori informazioni sulle singole clip estratte dall’audio. Questo campo è disponibile con un piano tariffario adeguato.
  • Aggiunta l’opzione ensure_face_per_frame nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL: il flag garantisce che i frame del video usati per la classificazione contengano un volto, migliorando l’accuratezza dell’analisi dei video in cui sono presenti volti quando è usato insieme a with_morphing.
  • Aggiunta l’opzione with_audio nell’API per la classificazione dei video e nell’API per la classificazione dei video da URL: il flag attiva l’analisi della traccia audio del video, ma per usarlo deve essere abilitato nel tuo piano tariffario. Quando è attivo, il sistema analizza la traccia audio del video per rilevare i deepfake, offrendo un’analisi più completa del contenuto del video.

Versione 1.1.1

2026-01-30

Funzionalità

  • Quando durante l’invio viene indicato un webhook_url e l’invio della notifica non riesce (ad es. per problemi di rete o URL non valido), il sistema ora riprova a inviare la notifica del webhook fino a 3 volte, con un intervallo di 10 s tra un tentativo e l’altro. Questo miglioramento aumenta l’affidabilità delle notifiche dei webhook per i client che le usano per aggiornamenti in tempo reale.
  • Corretto il valore di api_version nel payload di risposta delle API per il polling dei risultati, che ora riflette correttamente la versione corrente dell’API quando l’analisi è nello stato new.

Versione 1.1.0

2026-01-29

Funzionalità

  • Ai payload di risposta delle API per il polling dei risultati sono stati aggiunti i seguenti campi:
    • Status: indica lo stato dell’analisi (in corso, completata o non riuscita)
    • Errors: in caso di analisi non riuscita, indica il motivo dell’errore
    • API Version: riporta la versione dell’API al momento dell’analisi, per permettere il confronto tra analisi prodotte da versioni diverse del backend
  • Regolazione delle soglie interne artificiale/umano del modello Revelio Onboarding II: le soglie interne usate per classificare le immagini come artificiali o umane sono state adeguate per migliorare l’accuratezza del rilevamento in base ai dati di valutazione più recenti.

Versione 1.0.0

2025-01-01

Prima release

Benvenuto nella prima versione dell’API di identifAI. Questa release porta nelle tue applicazioni potenti funzionalità di rilevamento dei contenuti generati dall’IA.

Funzionalità

  • Classificazione delle immagini: rileva le immagini generate dall’IA con il nostro ensemble di più modelli (Revelio-IV, ecc.).
  • Analisi di video e audio: endpoint specializzati per rilevare i deepfake nei video e nelle voci.
  • Elaborazione asincrona: flusso di lavoro compatibile con i webhook, con invio e polling dei risultati.
  • API Partner: endpoint per la gestione degli utenti e dei crediti.