Share via

Face Recognition Operations - Verify Face To Face

  • Referência
Service:
Azure AI Services
API Version:
v1.1-preview.1

Verifique se dois rostos pertencem a uma mesma pessoa.

Nota

    • Uma maior qualidade da imagem facial significa uma melhor precisão de identificação. Considere rostos de alta qualidade: frontal, claro e tamanho do rosto é 200x200 pixels (100 pixels entre os olhos) ou maior.
    • Para os cenários sensíveis à precisão, faça o seu próprio juízo.
    • O "recognitionModel" associado a ambos os rostos deve ser o mesmo.
POST {endpoint}/face/{apiVersion}/verify

Parâmetros do URI

Name Em Necessário Tipo Description
apiVersion
 path True

string

Versão da API
endpoint
 path True

string

uri

Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://{resource-name}.cognitiveservices.azure.com).

Corpo do Pedido

Name Necessário Tipo Description
faceId1 True

string

O faceId de um rosto, proveniente de "Detetar".
faceId2 True

string

O faceId de outro rosto provém de "Detetar".

Respostas

Name Tipo Description
200 OK

VerificationResult

Uma chamada bem-sucedida devolve o resultado da verificação.
Other Status Codes

FaceErrorResponse

Uma resposta de erro inesperada.

Headers

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta da sua subscrição do Azure AI Face.

Type: apiKey
In: header

AADToken

Fluxo OAuth2 do Azure Active Directory

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

Exemplos

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
}

Definições

Name Description
FaceError

O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, consulte a seguinte ligação: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Uma resposta que contém detalhes de erro.
VerificationResult

Verifique o resultado.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, consulte a seguinte ligação: https://aka.ms/face-error-codes-and-messages.

Name Tipo Description
code

string

Um dos conjuntos de códigos de erro definidos pelo servidor.
message

string

Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta que contém detalhes de erro.

Name Tipo Description
error

FaceError

O objeto de erro.

VerificationResult

Verifique o resultado.

Name Tipo Description
confidence

number

Um número indica a confiança da semelhança de se dois rostos pertencem à mesma pessoa ou se o rosto pertence à pessoa. Por predefinição, isIdentical está definido como Verdadeiro se a confiança da semelhança for maior ou igual a 0,5. Isto é útil para os utilizadores avançados substituirem "isIdentical" e ajustarem o resultado nos seus próprios dados.
isIdentical

boolean

Verdadeiro se os dois rostos pertencerem à mesma pessoa ou o rosto pertencer à pessoa, caso contrário falso.