Vai al contenuto principale
Questo documento introduce le istruzioni per l’integrazione dell’API di rilevamento statico del volto (versione ad alta precisione), che può essere utilizzata per rilevare la vita attiva nelle immagini statiche caricate dagli utenti, al fine di determinare se si tratta di immagini riprodotte.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima andare alla pagina corrispondente dell’API di rilevamento statico del volto (versione ad alta precisione) per richiedere il servizio corrispondente. Una volta entrati nella pagina, fare clic sul pulsante “Acquire”, come mostrato nell’immagine: Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di accesso per invitare a registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si verrà automaticamente riportati alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare l’API senza costi.

​
Utilizzo di base

Innanzitutto, è importante comprendere il modo di utilizzo di base, che consiste nell’inserire il link dell’immagine per ottenere l’immagine di risultato elaborata. È necessario semplicemente trasmettere un campo image_url, l’immagine del volto è mostrata nell’immagine sottostante:

Possiamo quindi compilare i contenuti corrispondenti nell’interfaccia, come mostrato nell’immagine:

Si può notare che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • image_url: il link dell’immagine del volto da elaborare.
  • face_model_version: la versione del modello algoritmico utilizzato per il servizio di riconoscimento facciale. Attualmente, il parametro supporta “3.0”.
Dopo aver effettuato la selezione, si può notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” è possibile effettuare un test, come mostrato nell’immagine sopra, e qui abbiamo ottenuto il seguente risultato: 
{
  "score": 0,
  "face_model_version": "3.0"
}
Si può notare che in questo momento abbiamo ottenuto il risultato del rilevamento statico del volto, che include il punteggio di vita attiva. La descrizione dei campi è la seguente:
  • score: punteggio di vita attiva, con un intervallo di valori [0,100], che determina se si tratta di un’immagine riprodotta in base all’intervallo di soglia corrispondente al punteggio di vita attiva. Attualmente, le soglie possono essere suddivise in [5,10,40,70,90], con una soglia raccomandata di 40.
  • face_model_version: versione del modello algoritmico utilizzato per il riconoscimento facciale.
Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente: 
curl -X POST 'https://api.acedata.cloud/face/detect-live' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}'
Il codice di integrazione in Python è il seguente: 
import requests

url = "https://api.acedata.cloud/face/detect-live"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, si è superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusione

Attraverso questo documento, avete appreso come utilizzare l’API di rilevamento statico del volto (versione ad alta precisione) per rilevare la vita attiva nelle immagini statiche caricate dagli utenti, al fine di determinare se si tratta di immagini riprodotte. Speriamo che questo documento possa aiutarvi a integrare e utilizzare meglio l’API. Se avete domande, non esitate a contattare il nostro team di supporto tecnico.