Buscar 1:N | Live (Vida)

Servicio para buscar un rostro dentro de una colección y encontrar coincidencias.

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

La API de búsqueda te permite realizar una búsqueda 1:N para encontrar un FaceHash que coincida con el rostro proporcionado en los parámetros. Ejecuta un proceso de reconocimiento facial y devuelve una lista de personas coincidentes junto con sus detalles.

Verifik cuenta con una guía sobre qué son los servicios de búsqueda y cómo usarlos; te invitamos a leerla: Guía de Búsqueda.

Puedes utilizar los puntajes de similitud para determinar la calidad de las coincidencias. La información proporcionada sobre las personas coincidentes puede aplicarse en diversas áreas, como verificación de identidad, control de acceso y sistemas de seguridad que requieren reconocimiento facial.

Implementación

Header

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

specify the collection where you want to search the person (important when you have multiple projects)

Ejemplo de Body

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

Response

{
  "id": "vjca2",
  "data": [
    {
      "id": "651743f2b2eaf872c3541417",
      "name": "Mateo Verifik",
      "notes": "Verifik employee",
      "score": 0.9971,
      "gender": "M",
      "thumbnails": [
        {
          "id": "0a634411-717e-46c4-9c9a-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-b462-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-9216-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-a23d-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"
    },
    {
      "id": "65176209e09925fabe3de162",
      "name": "Mateo Verifik",
      "notes": "Verifik employee",
      "score": 0.9971,
      "gender": "M",
      "thumbnails": [
        {
          "id": "12d16680-e889-45f9-b260-729471fa6650",
          "thumbnail": "Base 64 image"
        }
      ],
      "collections": [],
      "create_date": "2023-09-29T23:47:22.721119",
      "nationality": "Colombian",
      "date_of_birth": "1995-05-07",
      "modified_date": "2023-09-29T23:47:22.721124"
    }
  ],
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "September 29, 2023 11:55 PM"
  }
}

Last updated