Searching for faces by image

General request format:

POST http://IP-address:port/firserver/FindFaces

Request parameters:

Parameter	Required	Parameter description
server_id	Yes	ID of the Face Recognition Server in the Face-Intellect software package
findPersons	Yes	The number of matches to be returned
image	Yes	Image in the base64 format

Request example:

POST http://127.0.0.1:10000/firserver/FindFaces

{
 "server_id" : "1",
 "findPersons": 2,
 "image" : "rvOGvR0Oxbx76+a8kIHXPfbzkbwY7hA9vpS5PRdb0j32pg4+yqerPT6Ghjw/Vhy9PpMQvWHqmb2U5VQ8kic/vWIS/b0xXNq8kJ7hPU7MGT2qdxw9FdAJPFXwtLxGLUQ9wBJCPLPiB71UMoU8vhbHPOThqb3VaSg92qH0PHOj1zyEdaa9ulOxvVfWq71oyOo8twbWu3g+mD0SQvw8C/KhvEjElrspZFi9Q7xsu6FLoL1mLa492n3tvCyBl7wNLl8+n+6RvRQnCbzDDhw9EnCAPdSsmT2PsHa8n+6HvTd6Cj0qT3U9oFQMveIDNj0m7sU8eih0vYGvgT3INIc9tWfXvevQnr1QMmG92WGHvf7Ulzxz74a8aCmlvXAa6j0vEMO8ApXTvGsowLwOuzC9TpGtO0eUfbzBOF4+SUgqPQpEvbyr+K08NJQTve1zZLrt6kQ9lvwEvZCE/j0R9B693z+APJK7l7x6K+W9yPTmO8ai1jp630U9OKUUPujXET0WnPa8DIW7PE32Z73Fkke8kYNmvZg/Lb2bv+o95BUKvYRH47yr70S8ojApvaMX5bwC4Co9AuwNvSFoWTyaXa09ueWFvPZ+RT3w7Mk7HnsLvDsmBD32PAW9IuphvSZLpTyBN5W9+e4sPcuAXr2RNI288I5hvYAm3LtEHnm9FFVFvIo8VL0ishw+QHjDPGGbhr2sJZK8E3a5PYsDK73kgKu8cN4/PB3Z8z10AE+9HWm7PRJhdr5l7Tm9LjRHvZtTA7wTW+08nGa4PXmX0bs1mwk8xrGcPBgNfzyfF7A6vYPWPaRxUL3jK8e7Y3KOvX5i77z543o9Xh/9PF0eAD24hrG8VYl1vRQnhrxGpcm8uuOCOdmlAz0z2AG+0cCHu6l/Yz1XdlA9fHPnvAZuij2dv9g7hlbYu47LJb1fUFM9IpIcvSRgBr7RC4Y9GgFCPeuYTLyw2oe9wUZNPZAPGr0GlEK96x2nvY29ybyQdZE9/v4jvcPhXbu9D309YWkWPYfTTD4S3fc9BtZqu3cfMLydFbu9IgSjO1PYMjx0rUA9Z1qgvSmWSj3BBlm8DcuvPWBNHr0eOYA9r5eIPMbslL26mIi852wHPvVfOD1wWPk8gHECvSVsgr3bM7i9GNleu+Lbfj0UDY29VU0hvv3xUzxaiAY9DtccPfk+BD0M+iy9IZABvRr35DzOpsy9G7VWPVmkoD26GAE9JBptvbtnL73QTFA9+fs3veiXx7v76o09m130O4OzRT3zog09YTimvAlnO71mTac8BPmCPcVQ8LzJ/yY9EdYUPSJpc704YWA9OCaRvRmzOr6bnjg7vLHWPBcI0ryxdKq8WsZ9PIINOD00RzO9MVeIuw==""
}

Response example:

{
 "FaceList": [
 {
 "eyeLeftX": 30.8689,
 "eyeLeftY": 48.5863,
 "eyeRightX": 57.8069,
 "eyeRightY": 48.1852,
 "faceRectLeft": 12,
 "faceRectTop": 32,
 "faceRectWidth": 64,
 "faceRectHeight": 64,
 "ProcessedPersons": 70,
 "ProcessedPersonsDuration": 0,
 "PersonList": [
 {
 "Id": "6C1069EB-1037-E711-9E4B-9C5C8E763A8F",
 "Name": "Hathaway",
 "Surname": "Anne",
 "Patronymic": "",
 "Department": "0",
 "Comment": "",
 "Timestamp": "2017-05-12T12:45:49.279",
 "ImageId": "6E1069EB-1037-E711-9E4B-9C5C8E763A8F",
 "Sim": "0.54350495338439941"
 }
  ]
 }
 ]
}

Response parameters:

Parameter	Parameter description
FaceList	List of faces
eyeLeftX	Left eye horizontal coordinates
eyeLeftY	Left eye vertical coordinates
eyeRightX	Right eye horizontal coordinates
eyeRightY	Right eye vertical coordinates
faceRectLeft	Face coordinates relative to the left edge of the frame
faceRectTop	Face coordinates relative to the top edge of the frame
faceRectWidth	Face width in pixels
faceRectHeight	Face height in pixels
ProcessedPersons	Number of generated vectors
ProcessedPersonsDuration	Time spent generating vectors
PersonList	A list of users with information from the faces database (see Getting information about users).
Sim	The degree of similarity of the face in the image in the request and the reference face from the face database

Page tree

Documentation for Face Intellect 8.0-8.1. Documentation for other versions of Intellect is available too.

General request format:

Request parameters:

Request example:

Response example:

Response parameters: