Volto reale o IA API

Introduzione API

Verifica se un volto sembra reale o generato dall’IA, inclusi i segnali di volti sintetici, scambio di volti tramite IA e ritocco intenso assistito dall’IA. Il modello analizza l’intera immagine e restituisce un punteggio di rischio di generazione IA.

Parametri di Richiesta: File di ritratto supportati fino a 10 MB.
Parametri di risposta: Un punteggio più alto indica segnali di generazione IA più forti sull’intera immagine. Usalo come segnale di revisione, non come prova che l’immagine sia reale.

Introduzione API

Verificare se una foto del profilo sembra reale o generata dall’IA
Esaminare selfie e ritratti per individuare segnali di volti sintetici
Individuare possibili scambi di volti tramite IA o ritocchi intensivi assistiti dall’IA

Autenticazione

Sostituisci {your-api-domain} con l’endpoint API mostrato nella dashboard del tuo account.

Autentica le richieste con l’endpoint API del tuo account e un token Bearer. Dopo l’acquisto dei crediti API, puoi vedere endpoint e token nella dashboard del tuo account. Mantieni segreto il token e non pubblicarlo mai in repository pubblici.

POSThttps://api.imgauth.com/v1/real-or-ai-face

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Parametri di Richiesta

Parametro	Tipo	✓	Descrizione
image	string	✓	File di ritratto supportati fino a 10 MB.

Esempio Richiesta HTTP

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Parametri di risposta

Parametro	Tipo	Descrizione
code	integer	Riferimento per i codici di risposta API
request_id	string	Usa questi esempi per costruire e debuggare la tua integrazione
data.ai_generated	boolean \| null	Immagine del volto probabilmente generata o modificata in modo sostanziale dall’IA / Nessun forte segnale di generazione IA rilevato
data.ai_generation_score	number \| null	Un punteggio più alto indica segnali di generazione IA più forti sull’intera immagine. Usalo come segnale di revisione, non come prova che l’immagine sia reale.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Revisione consigliata
data.analysis_scope	"portrait"	Verifica se un volto sembra reale o generato dall’IA, inclusi i segnali di volti sintetici, scambio di volti tramite IA e ritocco intenso assistito dall’IA. Il modello analizza l’intera immagine e restituisce un punteggio di rischio di generazione IA.

Esempi di Risposta

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "ai_generated": true,
    "ai_generation_score": 0.89,
    "review_status": "likely_ai",
    "analysis_scope": "portrait"
  }
}

Codici di Errore

400INVALID_REQUESTGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

401INVALID_API_KEYGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

402CREDITS_EXHAUSTEDGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

403API_KEY_INACTIVE / API_KEY_EXPIREDGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

413PAYLOAD_TOO_LARGEGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

415UNSUPPORTED_IMAGEGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

502UPSTREAM_ERRORGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

504UPSTREAM_TIMEOUTGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

Esempi di Codice

curl -X POST "https://api.imgauth.com/v1/real-or-ai-face" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}'