Liveness Session Operations - Get Liveness With Verify Session Result

Reference

Služba:: Azure AI Services

Verze rozhraní API:: v1.2

Získejte výsledek relace volání detectLivenessWithVerify/singleModal.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
sessionId	path	True	string	Jedinečné ID pro odkaz na tuto relaci.

Odpovědi

Name	Typ	Description
200 OK	LivenessWithVerifySession	Požadavek byl úspěšný.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

200 OK

LivenessWithVerifySession

Požadavek byl úspěšný.

Other Status Codes

FaceErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name	Description
https://cognitiveservices.azure.com/.default

Příklady

Get LivenessWithVerify Session Result

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
      }
    ]
  }
}

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
FaceRectangle	Obdélník, ve kterém lze najít tvář.
ImageType	Typ obrázku.
LivenessColorDecisionTarget	Cíl z barevného obrázku použitého pro klasifikaci živé aktivity.
LivenessDecision	Výsledek klasifikace aktivity.
LivenessDecisionTargets	Cíle používané pro klasifikaci aktivity.
LivenessError	Chyba klasifikace aktivity.
LivenessModel	Verze modelu používaná pro klasifikaci aktivity.
LivenessWithVerifyOutputs	Výstup ověření tváře.
LivenessWithVerifyReference	Podrobnosti o tváři pro ověření.
LivenessWithVerifyResult	Výsledky živé aktivity s ověřením volání.
LivenessWithVerifySession	Výsledek relace detekce živé aktivity s ověřením
LivenessWithVerifySessionAttempt	Živost s pokusem o ověření relace.
LivenessWithVerifySessionResults	Výsledky živé relace s ověřením.
OperationState	Aktuální stav relace.
QualityForRecognition	Označuje kvalitu obrázku pro rozpoznávání.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

FaceRectangle

Obdélník, ve kterém lze najít tvář.

Name	Typ	Description
height	integer	Výška obdélníku v pixelech.
left	integer	Vzdálenost od levého okraje, pokud je obrázek na levém okraji obdélníku v pixelech.
top	integer	Vzdálenost od horního okraje, pokud je obrázek na horním okraji obdélníku v pixelech.
width	integer	Šířka obdélníku v pixelech.

ImageType

Typ obrázku.

Name	Typ	Description
Color	string	Barevný obrázek
Depth	string	Obrázek hloubky
Infrared	string	Infračervený obraz.

LivenessColorDecisionTarget

Cíl z barevného obrázku použitého pro klasifikaci živé aktivity.

Name	Typ	Description
faceRectangle	FaceRectangle	Oblast tváře, ve které byla klasifikace aktivity provedena.

LivenessDecision

Výsledek klasifikace aktivity.

Name	Typ	Description
realface	string	Algoritmus klasifikoval cílovou tvář jako skutečnou.
spoofface	string	Algoritmus klasifikoval cílovou tvář jako falšování identity.
uncertain	string	Algoritmus nemohl klasifikovat cílovou tvář jako skutečnou ani jako falšování identity.

LivenessDecisionTargets

Cíle používané pro klasifikaci aktivity.

Name	Typ	Description
color	LivenessColorDecisionTarget	Cíl z barevného obrázku použitého pro klasifikaci živé aktivity.

LivenessError

Chyba klasifikace aktivity.

Name	Typ	Description
code	string	Kód chyby.
message	string	Chybová zpráva.
targets	LivenessDecisionTargets	Cíle používané pro klasifikaci aktivity

LivenessModel

Verze modelu používaná pro klasifikaci aktivity.

Name	Typ	Description
2024-11-15	string

LivenessWithVerifyOutputs

Výstup ověření tváře.

Name	Typ	Description
isIdentical	boolean	Určuje, jestli cílová tvář naživotnost a porovnání odpovídá tváři obrázku.
matchConfidence	number	Míra spolehlivosti ověření tváře cílové tváře a porovnání obrázku ověření tváře.

LivenessWithVerifyReference

Podrobnosti o tváři pro ověření.

Name	Typ	Description
faceRectangle	FaceRectangle	Oblast tváře, ve které byla provedena klasifikace srovnávacího obrázku.
qualityForRecognition	QualityForRecognition	Kvalita obrázku tváře pro rozpoznávání.
referenceType	ImageType	Typ obrázku, který obsahuje obdélník tváře, na kterém byla provedena klasifikace aktivity.

LivenessWithVerifyResult

Výsledky živé aktivity s ověřením volání.

Name	Typ	Description
digest	string	Server vypočítal hodnotu hash pro tento požadavek. Pokud se hodnota hash hlášeného klientem liší od počítané hodnoty hash serveru, došlo k ohrožení integrity zpráv mezi klientem a službou a výsledek by neměl být důvěryhodný. Další informace najdete v průvodcích, jak tuto hodnotu využít k zabezpečení kompletního řešení.
livenessDecision	LivenessDecision	Klasifikace aktivity pro cílovou tvář.
sessionImageId	string	ID image žádosti o relaci.
targets	LivenessDecisionTargets	Cíle používané pro klasifikaci aktivity
verifyImageHash	string	Hodnota hash sha256 obrázku verify-image v požadavku.
verifyResult	LivenessWithVerifyOutputs	Výstup ověření tváře. K dispozici pouze v případech, kdy je žádost aktivní s ověřením.

LivenessWithVerifySession

Výsledek relace detekce živé aktivity s ověřením

Name	Typ	Description
authToken	string	Nosný token, který poskytuje ověřování pro sadu Vision SDK spuštěnou v klientské aplikaci. Tento nosný token má omezená oprávnění k provedení pouze požadované akce a vyprší po uplynutí doby TTL. Je také možné ji auditovat.
modelVersion	LivenessModel	Verze modelu používaná pro klasifikaci aktivity. Jedná se o volitelný parametr a pokud není zadaný, zvolí se nejnovější podporovaná verze modelu.
results	LivenessWithVerifySessionResults	Výsledky živé relace s ověřením.
sessionId	string	Jedinečné ID pro odkaz na tuto relaci.
status	OperationState	Aktuální stav relace.

LivenessWithVerifySessionAttempt

Živost s pokusem o ověření relace.

Name	Typ	Description
attemptId	integer	ID pokusu začíná od 1.
attemptStatus	OperationState	Stav pokusu.
error	LivenessError	Chyba živého volání s ověřením bude null, pokud dojde k výsledku.
result	LivenessWithVerifyResult	Výsledek živého volání s ověřením bude null, pokud dojde k chybě.

LivenessWithVerifySessionResults

Výsledky živé relace s ověřením.

Name	Typ	Description
attempts	LivenessWithVerifySessionAttempt[]	Pokusy o data základní živé aktivity s ověřením volání v relaci.
verifyReferences	LivenessWithVerifyReference[]	Odkazy použité k ověření tváře.

OperationState

Aktuální stav relace.

Name	Typ	Description
Canceled	string	Operace byla zrušena uživatelem.
Failed	string	Operace se nezdařila.
NotStarted	string	Operace nebyla spuštěna.
Running	string	Operace probíhá.
Succeeded	string	Operace byla úspěšně dokončena.

QualityForRecognition

Označuje kvalitu obrázku pro rozpoznávání.

Name	Typ	Description
high	string	Vysoce kvalitní.
low	string	Nízká kvalita.
medium	string	Střední kvalita.

Sdílet prostřednictvím

Liveness Session Operations - Get Liveness With Verify Session Result

Parametry identifikátoru URI

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

AADToken

Rozsahy

Příklady

Get LivenessWithVerify Session Result

Ukázkový požadavek

Ukázková odpověď

Definice

FaceError

FaceErrorResponse

FaceRectangle

ImageType

LivenessColorDecisionTarget

LivenessDecision

LivenessDecisionTargets

LivenessError

LivenessModel

LivenessWithVerifyOutputs

LivenessWithVerifyReference

LivenessWithVerifyResult

LivenessWithVerifySession

LivenessWithVerifySessionAttempt

LivenessWithVerifySessionResults

OperationState

QualityForRecognition

Další materiály