Обнаружение объектов на фотографии

Чтобы обнаружить объект на фотографии, используйте следующий метод:

POST /detect

Тело запроса является обязательным и содержит multipart/form-data со следующими параметрами.

Название	Схема JSON	Описание
photo	binary	Исходный файл изображения.
attributes	объект	Атрибуты для объектов: лицо, автомобиль и силуэт.

Поле attributes может быть пустым или содержать объекты face, car и body со следующими параметрами для каждого объекта:

• age (возраст): тип boolean

• beard (борода): тип boolean

• emotions (эмоции): тип boolean

• glasses (очки): тип boolean

• gender (пол): тип boolean

• medmask (медицинская маска): тип boolean

• headpose (наклон головы): тип boolean

Прикрепите исходный файл изображения и отправьте POST запрос.

CURL пример

curl -X POST "http://<findface-ip:port>/detect" \
-H "Accept: application/json" \
-H "Content-Language: ru" \
-H "Accept-Language: ru" \
-H "Authorization: Token <token>" \
-H "Content-Type: multipart/form-data" \
-F "photo=@Смит_01.png" \
-F "attributes={
 "face": {
   "age": false,
   "beard": false,
   "emotions": false,
   "glasses": false,
   "gender": false,
   "medmask": false,
   "headpose": false
 },
 "car": {
   "description": false,
   "license_plate": false,
   "special_vehicle_type": false,
   "category": false,
   "weight_type": false,
   "orientation": false
 },
 "body": {
   "color": false,
   "clothes": false,
   "bags": false,
   "protective_equipment": false,
   "age_gender": false
 }
}" \

В случае успешного ответа (ОK: 200), возвращается объект со следующими параметрами. Пример.

Название	Схема JSON	Описание
orientation*	integer	Ориентация фотографии в формате EXIF.
objects	поддерживается любой из форматов: str┃int┃float┃bool┃object┃array┃null	Возвращаемые объекты с запрашиваемыми атрибутами.

Пример ответа

{
 "orientation": 1,
 "objects": {
   "face": [
     {
       "id": "cf0mbqev54rqhngnq940",
       "bbox": {
         "left": 451,
         "top": 235,
         "right": 645,
         "bottom": 502
       },
       "detection_score": 0.80645436,
       "low_quality": false,
       "features": {}
     },
     {
       "id": "cf0mbqev54rqhngnq94g",
       "bbox": {
         "left": 757,
         "top": 79,
         "right": 948,
         "bottom": 353
       },
       "detection_score": 0.90099674,
       "low_quality": false,
       "features": {}
     }
   ]
 }
}

В ответе вы получите ID объекта и координаты прямоугольника вокруг объекта (лица, автомобиля, силуэта). Скопируйте значение id интересующего вас объекта, чтобы использовать его для добавления объекта в карточку или для поиска объекта.