Liveness Session Operations - Get Liveness With Verify Session Result

Riferimento

Servizio:: Azure AI Services

Versione API:: v1.2

Ottiene il risultato della sessione di detectLivenessWithVerify/singleModal.

GET {endpoint}/face/{apiVersion}/detectLivenessWithVerify-sessions/{sessionId}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
apiVersion	path	True	string	Versione API
endpoint	path	True	string (uri)	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{nome-risorsa}.cognitiveservices.azure.com).
sessionId	path	True	string	ID univoco per fare riferimento a questa sessione.

Risposte

Nome	Tipo	Descrizione
200 OK	LivenessWithVerifySession	La richiesta ha avuto esito positivo.
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

LivenessWithVerifySession

La richiesta ha avuto esito positivo.

Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Get LivenessWithVerify Session Result

Esempio di richiesta

HTTP

GET {endpoint}/face/v1.2/detectLivenessWithVerify-sessions/b12e033e-bda7-4b83-a211-e721c661f30e

Risposta di esempio

Codice di stato:: 200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "status": "NotStarted",
  "modelVersion": "2024-11-15",
  "results": {
    "attempts": [
      {
        "attemptId": 2,
        "attemptStatus": "Succeeded",
        "result": {
          "livenessDecision": "realface",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          },
          "verifyResult": {
            "matchConfidence": 0.08871888,
            "isIdentical": false
          },
          "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
          "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I",
          "verifyImageHash": "43B7D8E8769533C3290DBD37A84D821B2C28CB4381DF9C6784DBC4AAF7E45018"
        }
      },
      {
        "attemptId": 1,
        "attemptStatus": "Failed",
        "error": {
          "code": "FaceWithMaskDetected",
          "message": "Mask detected on face image.",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          }
        }
      }
    ],
    "verifyReferences": [
      {
        "referenceType": "image",
        "faceRectangle": {
          "top": 316,
          "left": 131,
          "width": 498,
          "height": 677
        },
        "qualityForRecognition": "high"
      }
    ]
  }
}

Definizioni

Nome	Descrizione
FaceError	Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Risposta contenente i dettagli dell'errore.
FaceRectangle	Rettangolo all'interno del quale è possibile trovare un viso.
ImageType	Tipo di immagine.
LivenessColorDecisionTarget	Destinazione dell'immagine a colori usata per la classificazione del liveness.
LivenessDecision	Risultato della classificazione del liveness.
LivenessDecisionTargets	Destinazioni usate per la classificazione del liveness.
LivenessError	Errore della classificazione del liveness.
LivenessModel	Versione del modello usata per la classificazione del liveness.
LivenessWithVerifyOutputs	Output di verifica del viso.
LivenessWithVerifyReference	Dettaglio del viso per la verifica.
LivenessWithVerifyResult	Risultati della dinamica con la chiamata di verifica.
LivenessWithVerifySession	Risultato della sessione di rilevamento dell'attività con verifica.
LivenessWithVerifySessionAttempt	Liveness con il tentativo di verifica della sessione.
LivenessWithVerifySessionResults	Risultati della durata con la sessione di verifica.
OperationState	Stato corrente della sessione.
QualityForRecognition	Indica la qualità dell'immagine per il riconoscimento.

FaceError

Object

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
message	string	Rappresentazione leggibile dell'errore.

FaceErrorResponse

Object

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.

FaceRectangle

Object

Rettangolo all'interno del quale è possibile trovare un viso.

Nome	Tipo	Descrizione
height	integer (int32)	Altezza del rettangolo, in pixel.
left	integer (int32)	Distanza dal bordo sinistro se l'immagine al bordo sinistro del rettangolo, in pixel.
top	integer (int32)	Distanza dal bordo superiore se l'immagine al bordo superiore del rettangolo, in pixel.
width	integer (int32)	Larghezza del rettangolo, in pixel.

ImageType

Enumerazione

Tipo di immagine.

Valore	Descrizione
Color	Immagine a colori.
Depth	Immagine di profondità.
Infrared	Immagine a infrarossi.

LivenessColorDecisionTarget

Object

Destinazione dell'immagine a colori usata per la classificazione del liveness.

Nome	Tipo	Descrizione
faceRectangle	FaceRectangle	Area del viso in cui è stata effettuata la classificazione del livello di attività.

LivenessDecision

Enumerazione

Risultato della classificazione del liveness.

Valore	Descrizione
realface	L'algoritmo ha classificato il viso di destinazione come reale.
spoofface	L'algoritmo ha classificato il viso di destinazione come uno spoofing.
uncertain	L'algoritmo non è riuscito a classificare il viso di destinazione come reale o spoofing.

LivenessDecisionTargets

Object

Destinazioni usate per la classificazione del liveness.

Nome	Tipo	Descrizione
color	LivenessColorDecisionTarget	Destinazione dell'immagine a colori usata per la classificazione del liveness.

LivenessError

Object

Errore della classificazione del liveness.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
targets	LivenessDecisionTargets	Destinazioni usate per la classificazione del liveness.

LivenessModel

Enumerazione

Versione del modello usata per la classificazione del liveness.

Valore	Descrizione
2024-11-15

LivenessWithVerifyOutputs

Object

Output di verifica del viso.

Nome	Tipo	Descrizione
isIdentical	boolean	Indica se il viso di liveness di destinazione e il viso dell'immagine di confronto corrispondono.
matchConfidence	number (float) minimum: 0 maximum: 1	L'attendibilità della verifica del viso e dell'immagine di confronto del viso di destinazione.

LivenessWithVerifyReference

Object

Dettaglio del viso per la verifica.

Nome	Tipo	Descrizione
faceRectangle	FaceRectangle	Area del viso in cui è stata effettuata la classificazione dell'immagine di confronto.
qualityForRecognition	QualityForRecognition	Qualità dell'immagine del viso per il riconoscimento.
referenceType	ImageType	Tipo di immagine che contiene il rettangolo del viso in cui è stata eseguita la classificazione della dinamica.

LivenessWithVerifyResult

Object

Risultati della dinamica con la chiamata di verifica.

Nome	Tipo	Descrizione
digest	string	Digest calcolato del server per questa richiesta. Se il digest segnalato dal client è diverso dal digest calcolato del server, l'integrità del messaggio tra il client e il servizio è stata compromessa e il risultato non deve essere considerato attendibile. Per altre informazioni, vedere le guide su come sfruttare questo valore per proteggere la soluzione end-to-end.
livenessDecision	LivenessDecision	Classificazione del liveness per il viso di destinazione.
sessionImageId	string	ID immagine della richiesta di sessione.
targets	LivenessDecisionTargets	Destinazioni usate per la classificazione del liveness.
verifyImageHash	string	Hash sha256 dell'immagine di verifica nella richiesta.
verifyResult	LivenessWithVerifyOutputs	Output di verifica del viso. Disponibile solo quando la richiesta è attiva con la verifica.

LivenessWithVerifySession

Object

Risultato della sessione di rilevamento dell'attività con verifica.

Nome	Tipo	Descrizione
authToken	string	Token di connessione per fornire l'autenticazione per Vision SDK in esecuzione in un'applicazione client. Questo token di connessione dispone di autorizzazioni limitate per eseguire solo l'azione richiesta e scade dopo l'ora TTL. È anche controllabile.
modelVersion	LivenessModel	Versione del modello usata per la classificazione del liveness. Si tratta di un parametro facoltativo e, se non è specificato, verrà scelta la versione più recente del modello supportato
results	LivenessWithVerifySessionResults	Risultati della durata con la sessione di verifica.
sessionId	string	ID univoco per fare riferimento a questa sessione.
status	OperationState	Stato corrente della sessione.

LivenessWithVerifySessionAttempt

Object

Liveness con il tentativo di verifica della sessione.

Nome	Tipo	Descrizione
attemptId	integer (int32)	L'ID tentativo inizia da 1.
attemptStatus	OperationState	Stato del tentativo.
error	LivenessError	L'errore di liveness con la chiamata di verifica sarà Null se è presente un risultato.
result	LivenessWithVerifyResult	Il risultato della dinamica con la chiamata di verifica sarà Null se si verifica un errore.

LivenessWithVerifySessionResults

Object

Risultati della durata con la sessione di verifica.

Nome	Tipo	Descrizione
attempts	LivenessWithVerifySessionAttempt[]	I tentativi di dati di liveness sottostante con la chiamata di verifica con la sessione.
verifyReferences	LivenessWithVerifyReference[]	Riferimenti usati per la verifica del viso.

OperationState

Enumerazione

Stato corrente della sessione.

Valore	Descrizione
Canceled	L'operazione è stata annullata dall'utente.
Failed	L'operazione non è riuscita.
NotStarted	L'operazione non è stata avviata.
Running	L'operazione è in corso.
Succeeded	L'operazione è stata completata correttamente.

QualityForRecognition

Enumerazione

Indica la qualità dell'immagine per il riconoscimento.

Valore	Descrizione
high	Alta qualità.
low	Bassa qualità.
medium	Qualità media.

Condividi tramite

Liveness Session Operations - Get Liveness With Verify Session Result

Parametri dell'URI

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

AADToken

Ambiti

Esempio

Get LivenessWithVerify Session Result

Esempio di richiesta

Risposta di esempio

Definizioni

FaceError

FaceErrorResponse

FaceRectangle

ImageType

LivenessColorDecisionTarget

LivenessDecision

LivenessDecisionTargets

LivenessError

LivenessModel

LivenessWithVerifyOutputs

LivenessWithVerifyReference

LivenessWithVerifyResult

LivenessWithVerifySession

LivenessWithVerifySessionAttempt

LivenessWithVerifySessionResults

OperationState

QualityForRecognition