Face - Verify Face To Face

Servicio:

Azure AI Services

Versión de la API:

1.0-preview

Compruebe si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.
Observaciones:

• Una mayor calidad de imagen facial significa una mejor precisión de identificación. Tenga en cuenta las caras de alta calidad: el tamaño frontal, claro y facial es de 200 x 200 píxeles (100 píxeles entre los ojos) o más grandes.
• Para los escenarios que son sensibles a la precisión, por favor haga su propio juicio.
• El elemento "recognitionModel" asociado a las caras de consulta" debe ser el mismo que el "recognitionModel" usado por la cara de destino, el grupo de personas o el grupo de personas grandes.

POST {Endpoint}/face/v1.0-preview/verify

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
faceId1	True	string (uuid)	FaceId de la primera cara, procede de Face - Detect
faceId2	True	string (uuid)	FaceId de la segunda cara, procede de Face - Detect

Respuestas

Nombre	Tipo	Description
200 OK	VerifyResult	Una llamada correcta devuelve el resultado de la comprobación.
Other Status Codes	APIError	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Verify faces example

Solicitud de ejemplo

HTTP

POST {Endpoint}/face/v1.0-preview/verify


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

Respuesta de muestra

status code:

200

{
  "isIdentical": true,
  "confidence": 0.9
}

Definiciones

Nombre	Description
APIError	Información de error devuelta por la API
Error	Cuerpo del error.
VerifyFaceToFaceRequest	Cuerpo de la solicitud de verificación facial a cara.
VerifyResult	Resultado de la operación de comprobación.

APIError

Object

Información de error devuelta por la API

Nombre	Tipo	Description
error	Error	Cuerpo del error.

Error

Object

Cuerpo del error.

Nombre	Tipo	Description
code	string
message	string

VerifyFaceToFaceRequest

Object

Cuerpo de la solicitud de verificación facial a cara.

Nombre	Tipo	Description
faceId1	string (uuid)	FaceId de la primera cara, procede de Face - Detect
faceId2	string (uuid)	FaceId de la segunda cara, procede de Face - Detect

VerifyResult

Object

Resultado de la operación de comprobación.

Nombre	Tipo	Description
confidence	number minimum: 0 maximum: 1	Un número indica la similitud de si dos caras pertenecen a la misma persona o si la cara pertenece a la persona. De forma predeterminada, isIdentical se establece en True si la confianza de similitud es mayor o igual que 0,5. Esto resulta útil para que los usuarios avanzados invaliden "isIdentical" y ajusten el resultado en sus propios datos.
isIdentical	boolean	True si las dos caras pertenecen a la misma persona o a la cara pertenece a la persona; de lo contrario, false.