Face Recognition Operations - Verify Face To Face

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

Ellenőrizze, hogy két arc ugyanahhoz a személyhez tartozik-e.

Jegyzet

• • A jobb arcképminőség jobb azonosítási pontosságot jelent. Vegye figyelembe a kiváló minőségű arcokat: előtérbeli, világos és arcmérete 200x200 képpont (100 képpont a szem között) vagy nagyobb.
  • A pontosságra érzékeny forgatókönyvek esetében döntsön saját maga.
  • A két archoz társított "recognitionModel" értéknek azonosnak kell lennie.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string uri	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).

Kérelem törzse

Name	Kötelező	Típus	Description
faceId1	True	string	Az egyik arc faceId azonosítója a "Detect" (Észlelés) szóból származik.
faceId2	True	string	Egy másik arc faceId azonosítója a "Detect" (Észlelés) szóból származik.

Válaszok

Name	Típus	Description
200 OK	VerificationResult	A sikeres hívás visszaadja az ellenőrzési eredményt.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Típus: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://api.example.com/oauth2/authorize
Jogkivonat URL-címe: https://api.example.com/oauth2/token

Hatókörök

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

Példák

Verify Face to Face

Mintakérelem

HTTP

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

{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hibaadatokat tartalmazó válasz.
VerificationResult	Ellenőrizze az eredményt.

FaceError

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba ember által olvasható ábrázolása.

FaceErrorResponse

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

VerificationResult

Ellenőrizze az eredményt.

Name	Típus	Description
confidence	number	A szám azt jelzi, hogy két arc ugyanahhoz a személyhez tartozik-e, vagy hogy az arc az adott személyhez tartozik-e. Alapértelmezés szerint az isIdentical értéke Igaz, ha a hasonlóság megbízhatósága nagyobb vagy egyenlő 0,5-nél. Ez hasznos lehet a haladó felhasználók számára az "isIdentical" felülbírálása és az eredmény finomhangolása a saját adataikon.
isIdentical	boolean	Igaz, ha a két arc ugyanahhoz a személyhez tartozik, vagy az arc a személyhez tartozik, egyébként hamis.