Buesqueda 1:N

Servicio para realizar un proceso de detección de prueba de vida y luego buscar un rostro dentro de una colección para encontrar coincidencias.

POST - https://api.verifik.co/v2/face-recognition/search-live-face

La API Live Face Search te permite realizar una búsqueda 1:N utilizando un FaceScan en una colección de imágenes. Primero, ejecuta un proceso de detección de prueba de vida en la imagen proporcionada y luego busca rostros coincidentes dentro de la colección especificada.

Puedes utilizar el puntaje de prueba de vida (liveness score) y los puntajes de similitud para determinar el nivel de confianza en la prueba de vida y la calidad de las coincidencias. Esta API es útil para diversas aplicaciones, como verificación de identidad, control de acceso y sistemas de seguridad donde la detección de rostros en vivo es esencial.

Implementación

Headers

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

Body

Name	Type	Description
image	string	Name of the user
min_score	string	Age of the user
search_mode	string
collection_id	string
liveness_min_score	string

Body Example

{
    "images": ["base64_encoded_string"],
    "min_score": 0.7,
    "search_mode": "FAST/ACCURATE choose one",
    "collection_id": "ID_OF_COLLECTION",
    "liveness_min_score": 0.5
  }

Response

200

{
  "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"
  }
}

400

{
  "error": "Invalid request"
}