Face Recognition Operations - Verify From Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Ověřte, jestli tvář patří osobě ve skupině osob.

Poznámka

• • Vyšší kvalita obrazu tváře znamená lepší identifikaci přesnosti. Zvažte vysoce kvalitní tváře: přední, jasný a velikost obličeje je 200 × 200 pixelů (100 pixelů mezi očima) nebo větší.
  • V případě scénářů, které jsou citlivé na přesnost, proveďte vlastní úsudek.
  • Objekt recognitionModel přidružený k tváři dotazu by měl být stejný jako model recognitionModel používaný skupinou osob.

POST {endpoint}/face/{apiVersion}/verify

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

Text požadavku

Name	Vyžadováno	Typ	Description
faceId	True	string	FaceId tváře pochází z "Detect".
personGroupId	True	string	Použití existující personGroupId a personId pro rychlé načítání zadané osoby. personGroupId se vytvoří v části Vytvořit skupinu osob.
personId	True	string	Zadejte určitou osobu ve skupině osob.

Odpovědi

Name	Typ	Description
200 OK	VerificationResult	Úspěšné volání vrátí výsledek ověření.
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

Verify from PersonGroup

Ukázkový požadavek

HTTP

POST {endpoint}/face/v1.2-preview.1/verify

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c",
  "personGroupId": "your_person_group"
}

Ukázková odpověď

Stavový kód:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

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ě.
VerificationResult	Ověřte výsledek.

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.

VerificationResult

Ověřte výsledek.

Name	Typ	Description
confidence	number	Číslo označuje spolehlivosti podobnosti, zda dvě tváře patří stejné osobě, nebo jestli tvář patří osobě. Ve výchozím nastavení je vlastnost isIdentical nastavena na hodnotu True, pokud je spolehlivost podobnosti větší nebo rovna hodnotě 0,5. To je užitečné pro pokročilé uživatele, kteří přepíší "isIdentical" a vyladí výsledek na základě vlastních dat.
isIdentical	boolean	Pravda, pokud obě tváře patří stejné osobě nebo tvář patří osobě, jinak nepravda.