Распознавание лиц

HOST: https://smarty.mail.ru

Для распознавания лиц используются четыре метода API:

• set (/api/v1/persons/set);
• recognize (/api/v1/persons/recognize);
• delete (/api/v1/persons/delete);
• truncate (/api/v1/persons/truncate).

Рассмотрим каждый из них подробнее.

Данный метод позволяет установить связь между заданной фотографией и конкретным person_id.

Авторизационные данные передаются в строке запроса:

Поддерживаемые провайдеры OAuth2:

Параметры запроса передаются в формате JSON в теле запроса с name="meta":

Параметр space используется для избежания пересечений по person. Таким образом, person1 из space 0 и person1 из space 1 разные. Для приложений, решающих различные задачи, имеет смысл использовать различные значения space.

Клиент может иметь до 10 различных space. Значения space изменяются от 0 до 9. В случае превышения лимита вернется ошибка.

Параметры image_meta:

Изображения передаются в теле запроса, значения поля name должны соответствовать переданным в images.

Скопировать
curl -X 'POST' "https://smarty.mail.ru/api/v1/persons/set?oauth_token=<ваш токен>&oauth_provider=mcs"      \  -H 'accept: application/json' \  -H 'Content-Type: multipart/form-data' \  -F 'file=@persons_set_ok.jpg;type=image/jpeg' \  -F 'meta={  "space": "5",  "images": [    {      "name": "file",      "person_id": 1    }  ]}'

Параметры response:

Параметры object:

Скопировать
{  "status": 200,  "body": {    "objects": [      {        "status": 0,        "name": "file"      }    ]  },  "htmlencoded": false,  "last_modified": 0}

Данный метод позволяет распознать person по заданной фотографии. В случае, если совпадение не найдено, будет добавлен новый person.

Авторизационные данные передаются в строке запроса:

Поддерживаемые провайдеры OAuth2:

Параметры запроса передаются в формате JSON в теле запроса с name="meta":

Каждый раз, когда распознается известная персона, происходит обновление векторного представления лица (embedding) для лучшего распознания этой персоны в будущем. Однако в некоторых случаях лучше отключать автообновление с помощью параметра update_embedding, например, когда заведомо известно, что фотографии плохого качества.

Описание параметра space смотрите в разделе метода Set.

Параметры image_meta:

Изображения передаются в теле запроса, значения поля name должны соответствовать переданным в images.

Скопировать
curl -X 'POST' \  'https://smarty.mail.ru/api/v1/persons/recognize?oauth_token=<ваш токен>&oauth_provider=mcs' \  -H 'accept: application/json' \  -H 'Content-Type: multipart/form-data' \  -F 'file=@persons_recognize_ok_person_in_db.jpg;type=image/jpeg' \  -F 'meta={  "space": "5",  "create_new": false,  "images": [    {      "name": "file"    }  ]}'

Параметры response:

Параметры object:

Параметры person:

Только для второй модели:

Значение tag может равняться undefined в случае, если значение create_new в запросе равнялось false, и по предоставленному изображению в базе не был найден соответствующий person.

Скопировать
{  "status": 200,  "body": {    "objects": [      {        "status": 0,        "name": "file",        "persons": [          {            "tag": "person1",            "coord": [              567,              376,              992,              931            ],            "confidence": 0.99917,            "awesomeness": 0.4894,            "similarity": 0.9721,            "sex": "male",            "emotion": "Neutral",            "age": 34,            "valence": -0.3236,            "arousal": 0.185,            "frontality": 0.8921,            "visibility": 0.9985          }        ]      }    ]  },  "htmlencoded": false,  "last_modified": 0}

Данный метод позволяет удалить связь между фотографией и person_id.

Авторизационные данные передаются в строке запроса:

Поддерживаемые провайдеры OAuth2:

Параметры запроса передаются в формате JSON в теле запроса с name="meta":

Описание параметра space смотрите в разделе метода Set.

Параметры image_meta:

Изображения передаются в теле запроса, значения поля name должны соответствовать переданным в images.

Скопировать
curl -X 'POST' \  'https://smarty.mail.ru/api/v1/persons/delete?oauth_token=<ваш токен>&oauth_provider=mcs' \  -H 'accept: application/json' \  -H 'Content-Type: multipart/form-data' \  -F 'meta={  "space": "5",  "images": [    {      "name": "aaa",      "person_id": 1    }  ]}'

Параметры response:

Параметры object:

Скопировать
{  "status": 200,  "body": {    "objects": [      {        "status": 0,        "name": "aaa"      }    ]  },  "htmlencoded": false,  "last_modified": 0}

Данный метод позволяет полностью очистить space.

Авторизационные данные передаются в строке запроса:

Поддерживаемые провайдеры OAuth2:

Параметры запроса передаются в формате JSON в теле запроса с name="meta":

Описание параметра space смотрите в разделе метода Set.

Данный запрос не требует передачи изображений.

Скопировать
curl -X 'POST' \  'https://smarty.mail.ru/api/v1/persons/truncate?oauth_token=<ваш токен>&oauth_provider=mcs' \  -H 'accept: application/json' \  -H 'Content-Type: multipart/form-data' \  -F 'meta={  "space": "5"}'

Скопировать
{  "status": 200,  "body": {},  "htmlencoded": false,  "last_modified": 0}