Face Detect (Detección de rostro)

Servicio para detectar un rostro dentro de una imagen.

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

La API Face Detection te permite detectar rostros dentro de una imagen. Analiza la imagen proporcionada y devuelve información sobre los rostros detectados, incluyendo sus coordenadas, puntos de referencia (landmarks) y puntajes de detección.

collection_id

Para que el servicio funcione correctamente, se debe proporcionar un parámetro llamado collection_id. Este parámetro se obtiene al crear una nueva colección con el nombre "code".

A continuación, se muestra un ejemplo de una respuesta 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

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
max_results	string

Ejemplo de Body

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

Response

200

{
  "id": "pgui5",
  "data": [
    {
      "box": {
        "top": 169,
        "left": 698,
        "right": 1214,
        "bottom": 845
      },
      "persons": [],
      "landmarks": {
        "nose": [
          961,
          550
        ],
        "left_eye": [
          836,
          422
        ],
        "right_eye": [
          1080,
          425
        ],
        "left_mouth": [
          865,
          679
        ],
        "right_mouth": [
          1049,
          683
        ]
      },
      "thumbnail": "Base 64 image",
      "detection_score": 0.8
    }
  ],
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "September 29, 2023 9:10 PM"
  }
}

400

{
  "error": "Invalid request"
}