> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Segui le modifiche all'ecosistema dell'API v1 di identifAI. La versione ha la forma *MAJOR.MINOR.PATCH*:
- MAJOR è fisso a 1 per l'API v1.
- Il rilascio di nuovi endpoint o di modifiche che influiscono sui verdetti o sugli score delle classificazioni incrementa MINOR.
- Qualsiasi altra modifica incrementa PATCH.

## Versione 1.3.2

Più recente

2026-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](https://docs.identifai.net/it/classification/classify-image.md#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](https://docs.identifai.net/it/api-reference/classification/submit-an-image-for-classification.md), nell'[API per la classificazione delle immagini da URL](https://docs.identifai.net/it/api-reference/classification/submit-image-from-url.md), nell'[API per la classificazione dei video](https://docs.identifai.net/it/api-reference/classification/submit-a-video-for-classification.md) e nell'[API per la classificazione dei video da URL](https://docs.identifai.net/it/api-reference/classification/submit-video-from-url.md):
  * `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](https://docs.identifai.net/it/api-reference/classification/get-classification-result.md) e di ogni frame del [risultato della classificazione di un video](https://docs.identifai.net/it/api-reference/classification/get-classification-result-video.md): 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](https://docs.identifai.net/it/api-reference/classification/get-classification-xai.md): 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](https://docs.identifai.net/it/api-reference/classification/get-classification-heatmap.md).

Introdotti i **risultati differiti**: risultati prodotti dopo quelli principali, senza ritardarli, come le spiegazioni AI delle mappe XAI e della heatmap. Vedi [Risultati differiti](https://docs.identifai.net/it/api-reference/deferred-results.md).

* 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](https://docs.identifai.net/it/api-reference/classification/submit-an-image-for-classification.md) e nell'[API per la classificazione delle immagini da URL](https://docs.identifai.net/it/api-reference/classification/submit-image-from-url.md): 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](https://docs.identifai.net/it/classification/classify-image.md#smart-full-analysis) per maggiori dettagli.
* Aggiunta la stessa opzione `with_smart_analysis` nell'[API per la classificazione dei video](https://docs.identifai.net/it/api-reference/classification/submit-a-video-for-classification.md) e nell'[API per la classificazione dei video da URL](https://docs.identifai.net/it/api-reference/classification/submit-video-from-url.md): quando è abilitata, la Smart Full Analysis viene applicata a ogni frame analizzato. Vedi [Smart Full Analysis sui video](https://docs.identifai.net/it/classification/classify-video.md#smart-full-analysis).

## 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](https://docs.identifai.net/it/api-reference/classification/submit-a-video-for-classification.md) e nell'[API per la classificazione dei video da URL](https://docs.identifai.net/it/api-reference/classification/submit-video-from-url.md). 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](https://docs.identifai.net/it/classification/classify-video.md#momenti-specifici).
* **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](https://docs.identifai.net/it/api-reference/classification/submit-a-speech-for-classification.md) e nell'[API per la classificazione degli audio vocali da URL](https://docs.identifai.net/it/api-reference/classification/submit-speech-from-url.md), con lo stesso comportamento. Vedi [Classifica un audio vocale](https://docs.identifai.net/it/classification/classify-speech.md#analizza-momenti-specifici).
* **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](https://docs.identifai.net/it/classification/classify-video.md#volti)): è 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](https://docs.identifai.net/it/api-reference/classification/validate-media.md): 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](https://docs.identifai.net/it/api-reference/classification/submit-a-video-for-classification.md) e nell'[API per la classificazione dei video da URL](https://docs.identifai.net/it/api-reference/classification/submit-video-from-url.md): 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](https://docs.identifai.net/it/api-reference/classification/submit-a-video-for-classification.md) e nell'[API per la classificazione dei video da URL](https://docs.identifai.net/it/api-reference/classification/submit-video-from-url.md): 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](https://docs.identifai.net/it/api-reference/classification/get-classification-result.md),
  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](https://docs.identifai.net/it/api-reference/classification/get-classification-result.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.