Search 1:N | Crop

Servicio para buscar un rostro dentro de una colección y encontrar coincidencias, utilizando imágenes de hasta 120x120 px.

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

La API te permite realizar una consulta 1:N para buscar un FaceHash que coincida con el rostro proporcionado en los parámetros. El tamaño máximo de este Crop (imagen pequeña) es 120x120 píxeles.

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.

Este servicio está diseñado para aplicaciones que necesitan hacer coincidir imágenes más pequeñas de manera eficiente con una base de datos de personas registradas.

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

Body Example

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

Response

200

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

400

{
  "error": "Invalid request"
}