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_xaiellm_xai_languagenell’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_xaiabilita lo scope XAI; se la XAI non è inclusa nel tuo piano tariffario, il parametro viene ignorato;with_llm_xai, insieme awith_xai, abilita anche le spiegazioni AI; se il tuo piano include la XAI ma non le spiegazioni AI, la richiesta viene rifiutata con un errore403;llm_xai_languageimposta la lingua delle spiegazioni AI (english,italian,spanishogerman, senza distinzione tra maiuscole e minuscole); un valore non supportato viene rifiutato con un errore400. Se omesso, viene usata la lingua predefinita del tuo piano tariffario.
- Aggiunto il campo
explanationsai 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 suotype(attention_map,attention_graphoheatmap), ilmethodXAI e ladescriptionin linguaggio naturale. Le mappe sono elencate anche quando le spiegazioni AI non sono state richieste:descriptionènullse 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, ilmethodXAI e iltypedi mappa. Quando la XAI è combinata con la Smart Full Analysis, la heatmap si scarica comunque con l’endpoint per scaricare la heatmap.
- Aggiunta l’opzione
deferred_webhook_urlnelle API di classificazione di immagini, video e audio vocali (anche da URL): l’URL riceve una sola notifica, con l’eventosubmission.deferred.completed, quando i risultati differiti sono completi. Stessa abilitazione, stesse restrizioni sui domini e stessa autenticazione diwebhook_url. - Aggiunti
deferred_status,deferred_progressedeferred_errorsai 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.
status non cambiano.
Versione 1.3.1
2026-11-02
Funzionalità
- Aggiunta l’opzione
with_smart_analysisnell’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 conwith_heatmap, e una richiesta con entrambe le opzioni impostate atruerestituisce un errore422. Vedi Smart Full Analysis per maggiori dettagli. - Aggiunta la stessa opzione
with_smart_analysisnell’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 timecodeHH: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_timestampsnell’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_methodeensure_face_per_framevengono ignorati). Vedi Classifica un video. - Traccia audio del video: aggiunta l’opzione
audio_timestampsnelle stesse API per i video, da usare insieme awith_audio. La traccia audio viene analizzata in brevi segmenti centrati sui timecode indicati, invece che lungo tutta la sua durata. Può essere combinata conframes_timestampso usata da sola. - Voce: aggiunta l’opzione
audio_timestampsnell’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_timestampseaudio_timestampsvengono ignorati.
Modifiche
- Documentato
ensure_face_per_framecome 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_framesekey_frames_methodvengono ignorati quando è attiva) e viene ignorata quando è presenteframes_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
detailsnel 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’opzionewith_morphing).
Versione 1.1.2
2026-03-12
Funzionalità
- Aggiunto un campo
detailsnel 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_framenell’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 awith_morphing. - Aggiunta l’opzione
with_audionell’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_urle 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_versionnel payload di risposta delle API per il polling dei risultati, che ora riflette correttamente la versione corrente dell’API quando l’analisi è nello statonew.
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.