Share via

Face Recognition Operations - Verify Face To Face

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

Kontrollera om två ansikten tillhör samma person.

Anteckning

    • Högre bildkvalitet för ansiktsigenkänning innebär bättre identifieringsprecision. Överväg högkvalitativa ansikten: frontal, klar och ansiktsstorlek är 200 x 200 bildpunkter (100 bildpunkter mellan ögon) eller större.
    • För scenarier som är känsliga för noggrannhet gör du din egen bedömning.
    • Den "recognitionModel" som är associerad med båda ansiktena bör vara densamma.
POST {endpoint}/face/{apiVersion}/verify

URI-parametrar

Name I Obligatorisk Typ Description
apiVersion
 path True

string

API-version
endpoint
 path True

string

uri

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).

Begärandetext

Name Obligatorisk Typ Description
faceId1 True

string

FaceId för ett ansikte, kommer från "Detect".
faceId2 True

string

FaceId för ett annat ansikte, kommer från "Detect".

Svar

Name Typ Description
200 OK

VerificationResult

Ett lyckat anrop returnerar verifieringsresultatet.
Other Status Codes

FaceErrorResponse

Ett oväntat felsvar.

Headers

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Type: apiKey
In: header

AADToken

The Azure Active Directory OAuth2 Flow

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

Exempel

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
}

Definitioner

Name Description
FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Ett svar som innehåller felinformation.
VerificationResult

Verifiera resultatet.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name Typ Description
code

string

En av en serverdefinierad uppsättning felkoder.
message

string

En läsbar återgivning av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name Typ Description
error

FaceError

Felobjektet.

VerificationResult

Verifiera resultatet.

Name Typ Description
confidence

number

Ett tal anger likhetsförtroendet för om två ansikten tillhör samma person eller om ansiktet tillhör personen. Som standard är isIdentical inställt på Sant om likhetsförtroendet är större än eller lika med 0,5. Detta är användbart för avancerade användare att åsidosätta "isIdentical" och finjustera resultatet på sina egna data.
isIdentical

boolean

Sant om de två ansiktena tillhör samma person eller om ansiktet tillhör personen, annars falskt.