Megosztás a következőn keresztül:

Face Recognition Operations - Verify Face To Face

  • Referencia
Service:
Azure AI Services
API Version:
v1.1-preview.1

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

Megjegyzés

    • A jobb arcképminőség jobb azonosítási pontosságot jelent. Vegye figyelembe a kiváló minőségű arcokat: az előtérbeli, a tiszta és az arcméret 200x200 képpont (100 képpont a szem között) vagy nagyobb.
    • A pontosság szempontjából érzékeny forgatókönyvek esetében döntsön saját maga.
    • A két archoz társított "recognitionModel" kifejezésnek 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" szóból származik.
faceId2 True

string

Egy másik arc faceId azonosítója a "Detect" 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.

Headers

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2-folyamat

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Példák

Verify Face to Face

Sample Request

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

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

Sample Response

Status code:
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

A hiba részleteit 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 emberi olvasásra alkalmas ábrázolása.

FaceErrorResponse

A hiba részleteit 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 a megbízhatóságot jelzi, hogy két arc ugyanahhoz a személyhez tartozik-e, vagy hogy az arc az adott személyhez tartozik-e. Az isIdentical alapértelmezés szerint Igaz értékre van állítva, ha a hasonlóság megbízhatósága nagyobb vagy egyenlő 0,5-nél. Ez a speciális felhasználók számára hasznos 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.