Face Recognition Operations - Verify Face To Face

  • Referens
Tjänst:
Azure AI Services
API-version:
v1.2-preview.1

Kontrollera om två ansikten tillhör samma person.

Not

    • Högre ansiktsbildkvalitet innebär bättre identifieringsprecision. Överväg högkvalitativa ansikten: frontal, klar och ansiktsstorlek är 200 x 200 bildpunkter (100 bildpunkter mellan ögonen) 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 ska 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.

Sidhuvuden

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

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

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Verify Face to Face

Exempelbegäran

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

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

Exempelsvar

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

Definitioner

Name Description
FaceError

Felobjektet. Mer 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

Kontrollera resultatet.

FaceError

Felobjektet. Mer 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 mänsklig läsbar representation av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name Typ Description
error

FaceError

Felobjektet.

VerificationResult

Kontrollera resultatet.

Name Typ Description
confidence

number

Ett tal anger likhetsförtroendet för huruvida 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.