Vai al contenuto principale
Classifica un'immagine da URL

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
file_url
string
obbligatorio

L'URL dell'immagine da classificare.

ref_id
string

ID di riferimento facoltativo da associare alla richiesta di classificazione.

with_morphing
boolean

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

with_tampering
boolean

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

with_heatmap
boolean

Impostalo a true se vuoi ottenere anche una heatmap dei contenuti generati dall'IA.

with_smart_analysis
boolean

Impostalo a true per attivare la Smart Full Analysis: un algoritmo di scoring proprietario seleziona le aree più informative dell'immagine, 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: non può essere combinata con with_heatmap, e inviare entrambe le opzioni a true restituisce un errore 422. 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 dell'immagine su cui si sono concentrati durante la classificazione (attention map e attention graph). 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. 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).

Risposta

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

identifier
string
Esempio:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"