La API de Búsqueda de Rostros en Vivo te permite hacer una búsqueda 1:N usando un FaceScan en una colección de imágenes. Realiza la detección de vida en vivo en la imagen proporcionada y luego busca rostros en vivo coincidentes en la colección especificada.

Verifik tiene una guía sobre que son y como usar los servicios Search, lo invitamos a leerla: Guía Search.

Puedes utilizar la puntuación de vida y las puntuaciones de similitud para determinar el nivel de confianza en la vida y la calidad de las coincidencias. Esta API es valiosa para diversas aplicaciones, incluyendo verificación de identidad, control de acceso y sistemas de seguridad donde la detección de rostros en vivo es esencial.

collection_id

Para que el servicio funcione correctamente se debe suministrar un parámetro llamado collection_id, este parámetro se obtiene al crear una nueva colección con el nombre de code, Aquí hay un ejemplo de un response de creación de colección:

{
  "data": {
    "_id": "65175da13e81e4fabc12345",
    "deleted": false,
    "name": "Test2",
    "description": "Test Collection",
    "client": "65175da13e81e4fabc12345",
    "code": "dac2c81b-96a6-4f19-ab54-d1a72d55b64b", //Parametro a enviar en collection_id
    "updatedAt": "2023-09-29T23:28:33.894Z",
    "createdAt": "2023-09-29T23:28:33.894Z",
    "__v": 0
  }
}

Implementación

Consulta

import axios from 'axios';

const options = {
  method: 'POST',
  url: '<https://api.verifik.co/v2/face-recognition/search-live-face>',
  params: {
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  },
  data: {
    os: 'DESKTOP',
    image: 'base64_encoded_string',
    min_score: 0.7,
    search_mode: 'FAST/ACCURATE choose one',
    collection_id: 'OPTIONAL_COLLECTION_ID_TO_RESTRICT_SEARCH',
    liveness_min_score: 0.5
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Respuesta 200 - (Consulta Exitosa)

{
  "id": "ga8sn",
  "data": {
    "persons": [
      {
        "id": "651743f2b2eaf872c3541417",
        "name": "Mateo Verifik",
        "notes": "Verifik employee",
        "score": 0.9971,
        "gender": "M",
        "thumbnails": [
          {
            "id": "0a634411-717e-46c4-93ac-8d7e8f92eef8",
            "thumbnail": "Base 64 Image"
          }
        ],
        "collections": [],
        "create_date": "2023-09-29T21:38:59.306976",
        "nationality": "Colombian",
        "date_of_birth": "1995-05-07",
        "modified_date": "2023-09-29T21:38:59.306981"
      },
      {
        "id": "65175ee13e81e4fad02676a3",
        "name": "Mateo Verifik",
        "notes": "Verifik employee",
        "score": 0.9971,
        "gender": "M",
        "thumbnails": [
          {
            "id": "6441f973-7668-471c-b1x2-1aaeac19fd36",
            "thumbnail": "Base 64 Image"
          }
        ],
        "collections": [],
        "create_date": "2023-09-29T23:33:54.056053",
        "nationality": "Colombian",
        "date_of_birth": "1995-05-07",
        "modified_date": "2023-09-29T23:33:54.056058"
      },
      {
        "id": "65175f133e81e4fad02676ad",
        "name": "Mateo Verifik",
        "notes": "Verifik employee",
        "score": 0.9971,
        "gender": "M",
        "thumbnails": [
          {
            "id": "60855a0d-6ad7-4f28-9wcv6-20bc061520fd",
            "thumbnail": "Base 64 Image"
          }
        ],
        "collections": [],
        "create_date": "2023-09-29T23:34:44.234518",
        "nationality": "Colombian",
        "date_of_birth": "1995-05-07",
        "modified_date": "2023-09-29T23:34:44.234524"
      },
      {
        "id": "65175f713e81e4fad02676bf",
        "name": "Mateo Verifik",
        "notes": "Verifik employee",
        "score": 0.9971,
        "gender": "M",
        "thumbnails": [
          {
            "id": "9403c70c-d760-4be1-abvc-8f3d2455f06f",
            "thumbnail": "Base 64 Image"
          }
        ],
        "collections": [],
        "create_date": "2023-09-29T23:36:18.370250",
        "nationality": "Colombian",
        "date_of_birth": "1995-05-07",
        "modified_date": "2023-09-29T23:36:18.370255"
      }
    ],
    "liveness_score": 0.98
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "September 29, 2023 11:40 PM"
  }
}