Face Recognition Operations - Verify From Person Directory

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2

Ellenőrizze, hogy az arc egy személyhez tartozik-e a Person Directoryban.

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.
  • Az Ellenőrzés művelet csak a lekérdezési archoz társított azonos felismerési modellel kapott arcokat tudja egyeztetni.

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
faceId	True	string (uuid)	Az arc faceId azonosítója a "Detect" (Észlelés) szóból származik.
personId	True	string (uuid)	Adjon meg egy személyt a PersonDirectory Person alkalmazásban.

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 from PersonDirectory

Mintakérelem

HTTP

POST {endpoint}/face/v1.2/verify

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

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

Objektum

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

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

VerificationResult

Objektum

Ellenőrizze az eredményt.

Name	Típus	Description
confidence	number (float) minimum: 0 maximum: 1	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.