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

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Maak een nieuwe livenesssessie met verificatie. Geef de verificatie-installatiekopie op tijdens het maken van de sessie.
Een sessie is het meest geschikt voor clientapparaatscenario's waarbij ontwikkelaars een clientapparaat willen autoriseren om alleen een detectie van liveness uit te voeren zonder volledige toegang te verlenen tot hun resource. Gemaakte sessies hebben een beperkte levensduur en autoriseren clients alleen om de gewenste actie uit te voeren voordat de toegang is verlopen.

Machtigingen omvatten...

• • Mogelijkheid om /detectLivenessWithVerify/singleModal aan te roepen voor maximaal 3 nieuwe pogingen.
  • Een tokenlevensduur van 10 minuten.

Notitie

• • Clienttoegang kan worden ingetrokken door de sessie te verwijderen met behulp van de bewerking Liveness verwijderen met verificatiesessie.
  • Als u een resultaat wilt ophalen, gebruikt u de sessie Liveness ophalen met verificatie.
  • Als u de afzonderlijke aanvragen wilt controleren die een client heeft ingediend bij uw resource, gebruikt u de lijst liveness met controle-vermeldingen voor sessiecontrole.

Aanbevolen optie: VerifyImage wordt geleverd tijdens het maken van de sessie.

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

URI-parameters

Name	In	Vereist	Type	Description
Parameters	formData	True	string	De parameters voor het maken van een sessie.
VerifyImage	formData	True	file	De installatiekopieënstroom voor verificatie. Het veld Koptekst voor inhoudsopstelling voor dit onderdeel moet de bestandsnaam hebben.
apiVersion	path	True	string	API-versie
endpoint	path	True	string (uri)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

Antwoorden

Name	Type	Description
200 OK	CreateLivenessWithVerifySessionResult	Een geslaagde aanroep maakt een sessie voor een clientapparaat en geeft een autorisatietoken op voor gebruik door de clienttoepassing voor een beperkt doel en tijd.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Create LivenessWithVerify Session with VerifyImage

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
CreateLivenessWithVerifySessionResult	Antwoord van de livenesssessie met het verifiëren van het maken met de opgegeven verificatie-installatiekopie.
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
FaceRectangle	Een rechthoek waarin een gezicht kan worden gevonden.
LivenessWithVerifyImage	Het detail van het gezicht voor verificatie.
QualityForRecognition	Geeft de kwaliteit van de afbeelding aan voor herkenning.

CreateLivenessWithVerifySessionResult

Object

Antwoord van de livenesssessie met het verifiëren van het maken met de opgegeven verificatie-installatiekopie.

Name	Type	Description
authToken	string	Bearer-token voor verificatie voor de Vision-SDK die wordt uitgevoerd op een clienttoepassing. Dit Bearer-token heeft beperkte machtigingen om alleen de vereiste actie uit te voeren en verloopt na de TTL-tijd. Het is ook controleerbaar.
sessionId	string	De unieke sessie-id van de gemaakte sessie. Het verloopt 48 uur nadat deze is gemaakt of kan eerder worden verwijderd met behulp van de bijbehorende sessie-DELETE-bewerking.
verifyImage	LivenessWithVerifyImage	Het detail van het gezicht voor verificatie.

FaceError

Object

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

FaceRectangle

Object

Een rechthoek waarin een gezicht kan worden gevonden.

Name	Type	Description
height	integer (int32)	De hoogte van de rechthoek, in pixels.
left	integer (int32)	De afstand van de linkerrand als de afbeelding naar de linkerrand van de rechthoek, in pixels.
top	integer (int32)	De afstand van de bovenrand als de afbeelding naar de bovenrand van de rechthoek, in pixels.
width	integer (int32)	De breedte van de rechthoek, in pixels.

LivenessWithVerifyImage

Object

Het detail van het gezicht voor verificatie.

Name	Type	Description
faceRectangle	FaceRectangle	Het gezichtsgebied waar de classificatie van de vergelijkingsafbeelding is gemaakt.
qualityForRecognition	QualityForRecognition	Kwaliteit van gezichtsafbeelding voor herkenning.

QualityForRecognition

Inventarisatie

Geeft de kwaliteit van de afbeelding aan voor herkenning.

Waarde	Description
high	Hoge kwaliteit.
low	Lage kwaliteit.
medium	Gemiddelde kwaliteit.