Liveness Session Operations - Create Liveness With Verify Session With Verify Image

Servizio:

Azure AI Services

Versione API:

v1.1-preview.1

Create una nuova sessione di attività con verifica. Specificare l'immagine di verifica durante la creazione della sessione.
Una sessione è ideale per gli scenari di dispositivi client in cui gli sviluppatori vogliono autorizzare un dispositivo client a eseguire solo un rilevamento della attività senza concedere l'accesso completo alla risorsa. Le sessioni create hanno un intervallo di vita limitato e autorizzano solo i client a eseguire l'azione desiderata prima della scadenza dell'accesso.

Le autorizzazioni includono...

• • Possibilità di chiamare /detectLivenessWithVerify/singleModal per un massimo di 3 tentativi.
  • Durata del token di 10 minuti.

Nota

• • L'accesso client può essere revocato eliminando la sessione usando l'operazione Elimina attività con verifica sessione.
  • Per recuperare un risultato, usare la sessione Get Liveness With Verify.
  • Per controllare le singole richieste effettuate da un client alla risorsa, usare le voci List Liveness With Verify Session Audit .

Opzione consigliata: VerifyImage viene fornita durante la creazione della sessione.

POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Parameters	formData	True	string	Parametri per la creazione della sessione.
VerifyImage	formData	True	file	Flusso di immagini per la verifica. Il campo intestazione Content-Disposition per questa parte deve avere un nome file.
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).

Risposte

Nome	Tipo	Descrizione
200 OK	CreateLivenessWithVerifySessionResult	Una chiamata riuscita crea una sessione per un dispositivo client e fornisce un token di autorizzazione per l'uso da parte dell'applicazione client per uno scopo e un tempo limitati.
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

Create LivenessWithVerify Session with VerifyImage

Esempio di richiesta

HTTP

POST {endpoint}/face/v1.1-preview.1/detectLivenessWithVerify/singleModal/sessions

Risposta di esempio

Codice di stato:

200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "verifyImage": {
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "qualityForRecognition": "high"
  }
}

Definizioni

Nome	Descrizione
CreateLivenessWithVerifySessionResult	Risposta della sessione di attività con verifica della creazione con l'immagine di verifica fornita.
FaceError	Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, fare riferimento al 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.
LivenessWithVerifyImage	Dettaglio del viso per la verifica.
QualityForRecognition	Indica la qualità dell'immagine per il riconoscimento.

CreateLivenessWithVerifySessionResult

Risposta della sessione di attività con verifica della creazione con l'immagine di verifica fornita.

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.
sessionId	string	ID sessione univoco della sessione creata. Scadrà 48 ore dopo la creazione o potrebbe essere eliminato prima usando l'operazione SESSION DELETE corrispondente.
verifyImage	LivenessWithVerifyImage	Dettaglio del viso per la verifica.

FaceError

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

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

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.

FaceRectangle

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

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

LivenessWithVerifyImage

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.

QualityForRecognition

Indica la qualità dell'immagine per il riconoscimento.

Nome	Tipo	Descrizione
high	string	Qualità elevata.
low	string	Bassa qualità.
medium	string	Qualità media.