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

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Vytvořte novou relaci živého života s ověřením. Zadejte obrázek ověření během vytváření relace.
Relace je nejvhodnější pro scénáře klientských zařízení, ve kterých chtějí vývojáři autorizovat klientské zařízení, aby provádělo detekci živé aktivity, aniž by udělili úplný přístup ke svému prostředku. Vytvořené relace mají omezenou životnost a autorizuje klienty pouze k provedení požadované akce před vypršením platnosti přístupu.

Oprávnění zahrnují...

• • Schopnost volat /detectLivenessWithVerify/singleModal až pro 3 opakování.
  • Životnost tokenu je 10 minut.

Poznámka

• • Klientský přístup je možné odvolat odstraněním relace pomocí operace Odstranit liveness s ověřením relace.
  • Pokud chcete načíst výsledek, použijte relaci Získat liveness s ověřením.
  • Pokud chcete auditovat jednotlivé požadavky, které klient provedl pro váš prostředek, použijte položky auditu relace List Liveness with Verify Session.

Doporučená možnost: Během vytváření relace je k dispozici ověřeníimage.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
Parameters	formData	True	string	Parametry pro vytvoření relace.
VerifyImage	formData	True	file	Stream obrázku pro ověření. Pole hlavičky Content-Disposition pro tuto část musí obsahovat název souboru.
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).

Odpovědi

Name	Typ	Description
200 OK	CreateLivenessWithVerifySessionResult	Úspěšné volání vytvoří relaci pro klientské zařízení a poskytne autorizační token pro použití klientskou aplikací pro omezený účel a čas.
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

Create LivenessWithVerify Session with VerifyImage

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
CreateLivenessWithVerifySessionResult	Odpověď relace aktivity s ověřením vytvoření s poskytnutým ověřením image
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ář.
LivenessWithVerifyImage	Podrobnosti o tváři pro ověření.
QualityForRecognition	Označuje kvalitu obrázku pro rozpoznávání.

CreateLivenessWithVerifySessionResult

Odpověď relace aktivity s ověřením vytvoření s poskytnutým ověřením image

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.
sessionId	string	Jedinečné ID relace vytvořené relace. Platnost vyprší 48 hodin po jeho vytvoření nebo může být odstraněna dříve pomocí odpovídající operace ODSTRANĚNÍ relace.
verifyImage	LivenessWithVerifyImage	Podrobnosti o tváři pro ověření.

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.

LivenessWithVerifyImage

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í.

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.