Comparar 1:1

Servicio para comparar dos imágenes.

Este servicio te ayuda a comparar una selfie única (llamada "probe") con una colección de selfies (llamada "gallery") para verificar identidades y realizar una detección de prueba de vida en la imagen de prueba. Es ideal para controlar el acceso a tu aplicación o completar verificaciones de Conoce a tu Cliente (KYC) de manera segura.

¡Desglosemos el proceso paso a paso!

Endpoint

https://api.verifik.co/v2/face-recognition/compare

La API de comparación facial te permite realizar una comparación 1:1 para encontrar similitudes faciales. Ofrece la capacidad de analizar y puntuar el parecido entre dos imágenes, que pueden ser imágenes de un documento o imágenes de una cámara, siempre que sean diferentes entre los parámetros "gallery" y "probe".

Asegúrate de proporcionar imágenes válidas codificadas en base64 en la solicitud y elige el modo de búsqueda adecuado para tus necesidades específicas (FAST o ACCURATE). La respuesta contendrá información esencial sobre el trabajo de comparación, incluidos los sellos de tiempo y los detalles de certificación.

Comparación 1:1 vs. Verificación Facial

Si has leído todas las guías de esta documentación, habrás notado que estos servicios realizan procesos muy similares, entonces, ¿qué los diferencia?

El factor diferenciador entre estos servicios es cómo se lleva a cabo el proceso de comparación:

• Face Verify: Realiza la comparación entre una imagen y una persona ya creada dentro de una colección.

• Compare 1:1: Realiza la comparación entre dos imágenes. A diferencia de Face Verify, no hay restricciones sobre el origen de estas imágenes, lo que hace que este servicio sea más versátil en la comparación 1:1.

• Compare 1:1 Live: Funciona de la misma manera que el servicio Compare 1:1, con el valor añadido de realizar una verificación de prueba de vida en una de las imágenes proporcionadas.

Mejores Prácticas

• Seguridad: Mantén tu token de API seguro y utiliza HTTPS.

• Calidad de imagen: Usa selfies claras y bien iluminadas para obtener mejores resultados.

• Pruebas: Prueba con diferentes dispositivos (iOS, Android) y tamaños de galería.

• Umbrales: Comienza con los valores predeterminados de min_score, luego ajusta según falsos positivos/negativos.

Ejemplos

Solución de Problemas

¿No hay coincidencia?

• Verifica la calidad de la imagen o prueba el modo ACCURATE.

• Asegúrate de que la galería contiene los rostros correctos.

¿Errores?

• Verifica tu token y la codificación en base64.

Lo que Necesitas

• Una selfie para comparar (probe).

• Un conjunto de selfies para comparar (gallery).

• Un token de API (obtenlo desde el panel de Verifik o desde las APIs de autenticación).

¿Listo para integrar?

Sigue el ejemplo de código, prueba con tus selfies y ajusta los puntajes según las necesidades de tu aplicación.

Encabezados

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
os	string	OS from where you are doing the operation. [DESKTOP, IOS, ANDROID]
probe	string	Face encoded in base64
gallery	Array	Array of images to compare with the face inside probe.
search_mode	string	search mode, it could be FAST, ACCURATE.

Ejemplo de Body

{
    "os": "DESKTOP",
    "probe": "base64_encoded_string",
    "gallery": ["base64_encoded_string"],
    "search_mode": "FAST/ACCURATE choose one, default FAST"
}

Response

200

{
  "id": "0jy93",
  "data": {
    "__v": 0,
    "_id": "65171e23640f7872b17ed99d",
    "type": "compare",
    "probe": [
      "Base 64 image"
    ],
    "client": "64404b1f9856cc8cebd762e7",
    "result": {
      "score": 1
    },
    "deleted": false,
    "gallery": [
      "Base 64 image"
    ],
    "createdAt": "2023-09-29T18:57:42.028Z",
    "updatedAt": "2023-09-29T18:57:42.028Z",
    "comparedAt": "2023-09-29T18:57:39.059Z",
    "search_mode": "FAST"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "September 29, 2023 6:57 PM"
  }
}

400

{
  "error": "Invalid request"
}