Написать в техподдержку Позвонить нам
Админпанель Выход

Содержание статьи:

    Пример интеграции на Python

    Попробуем распознать лица на фотографии:

    image

    Скачайте файл smarty.py.

    python examples/python/smarty.py \
    -u "https://smarty.mail.ru/api/v1/persons/recognize?oauth_provider="mcs&oauth_token=e50b000614a371ce99c01a80a4558d8ed93b313737363830" \
    -p examples/friends1.jpg \
    --meta '{"space":"1", "create_new":false}' \
    -v

    Получим ответ:

    {
    "status":200,
    "body":{
    "objects": [
    {
    "status":0,
    "name":"file_0",
    "persons":[
    {"tag":"undefined","coord":[102,30,184,134],"confidence":0.99999,"awesomeness":0.5025},
    {"tag":"undefined","coord":[393,74,461,166],"confidence":0.99987,"awesomeness":0.548},
    {"tag":"undefined","coord":[458,48,535,149],"confidence":0.99976,"awesomeness":0.4766},
    {"tag":"undefined","coord":[273,45,352,147],"confidence":0.99963,"awesomeness":0.504},
    {"tag":"undefined","coord":[525,81,600,184],"confidence":0.99954,"awesomeness":0.4849},
    {"tag":"undefined","coord":[194,76,258,167],"confidence":0.9984,"awesomeness":0.5725}
    ]
    }
    ],
    "aliases_changed":false
    },
    "htmlencoded":false,
    "last_modified":0
    }

    Как видим, на фотографии нашлось 6 лиц, но все они "undefined". Что значит "undefined"?Это значит, что в базе данных еще нет ни одной распознанной персоны.

    Обратите внимание на параметры "space":"1" и "create_new":false, их значение вскоре станетпонятно из примеров.

    Добавление персоны в базу данных

    Попробуем добавить в базу данных персону.На этой фотографии одна персона:

    image

    Мы установим, что эта персона имеет id=1 в базе данных. Сделаем это с помощью следующего запроса и параметра "person_id":1.

    python examples/python/smarty.py \
    -u "https://smarty.mail.ru/api/v1/persons/set?oauth_provider=mcs&oauth_token=e50b000614a371ce99c01a80a4558d8ed93b313737363830" \
    -p examples/rachel-green.jpg \
    --meta '{"space":"1", "images":[{"person_id":1}]}' \
    -v

    Если запрос верный, ответ будет такой:

    {
    "status":200,
    "body":{
    "objects":[
    {"status":0,"name":"file_0"}
    ]
    },
    "htmlencoded":false,
    "last_modified":0
    }

    Теперь попробуем поискать лица снова.Выполняем тот же запрос:

    python examples/python/smarty.py \
    -u "https://smarty.mail.ru/api/v1/persons/recognize?oauth_provider=mcs&oauth_token=e50b000614a371ce99c01a80a4558d8ed93b313737363830" \
    -p examples/friends1.jpg \
    --meta '{"space":"1", "create_new":false}' \
    -v

    На этот раз получим ответ:

    {
    "status":200,
    "body":{
    "objects": [
    {
    "status":0,
    "name":"file_0",
    "persons":[
    {"tag":"undefined","coord":[102,30,184,134],"confidence":0.99999,"awesomeness":0.5025},
    {"tag":"undefined","coord":[393,74,461,166],"confidence":0.99987,"awesomeness":0.548},
    {"tag":"undefined","coord":[458,48,535,149],"confidence":0.99976,"awesomeness":0.4766},
    {"tag":"undefined","coord":[273,45,352,147],"confidence":0.99963,"awesomeness":0.504},
    {"tag":"undefined","coord":[525,81,600,184],"confidence":0.99954,"awesomeness":0.4849},
    {"tag":"person1","coord":[194,76,258,167],"confidence":0.9984,"awesomeness":0.5725}
    ]
    }
    ],
    "aliases_changed":false
    },
    "htmlencoded":false,
    "last_modified":0
    }

    Теперь на фотографии с шестью персонами мы находим персону, которую мы загрузили с помощью метода persons/set. Мы загружали в базу данных персону с id=1, и теперь она распознана:

    "tag":"person1"

    Параметр create_new

    Теперь вернемся в самое начало и представим, что мы еще не загружали персоны в базу данных. Попробуем выполнить запрос с "create_new":true:

    python examples/python/smarty.py \
    -u "https://smarty.mail.ru/api/v1/persons/recognize?oauth_provider=mcs&oauth_token=e50b000614a371ce99c01a80a4558d8ed93b313737363830" \
    -p examples/friends1.jpg \
    --meta '{"space":"1", "create_new":true}' \
    -v

    В ответе:

    {
    "status":200,
    "body":{
    "objects": [
    {
    "status":0,
    "name":"file_0",
    "persons":[
    {"tag":"person1","coord":[102,30,184,134],"confidence":0.99999,"awesomeness":0.5025},
    {"tag":"person2","coord":[393,74,461,166],"confidence":0.99987,"awesomeness":0.548},
    {"tag":"person3","coord":[458,48,535,149],"confidence":0.99976,"awesomeness":0.4766},
    {"tag":"person4","coord":[273,45,352,147],"confidence":0.99963,"awesomeness":0.504},
    {"tag":"person5","coord":[525,81,600,184],"confidence":0.99954,"awesomeness":0.4849},
    {"tag":"person6","coord":[194,76,258,167],"confidence":0.9984,"awesomeness":0.5725}
    ]
    }
    ],
    "aliases_changed":false
    },
    "htmlencoded":false,
    "last_modified":0
    }

    Видно, что все найденные персоны автоматически записались в базу данных, и им присвоены id. Если теперь поискать Рейчел методом persons/recognize, то теперь она будет распознана как "person6".

    Параметр space

    Позволяет создавать непересекающиеся наборы персон. Например, в "space":"1" можно загрузить (persons/set) всех персонажей сериала "Друзья", а в "space":"2" - всех персонажей сериала "Бригада".Теперь можно создать автоматическую пропускную систему:

    • на голливудской киностудии стоит искать (вызывать persons/recognize) в "space":"1",
    • в московской—в "space":"2".

    Удаление персон

    Если нужно почистить спейс (space) или какую-то персону добавили в базу данных по ошибке, необходимо использовать запрос persons/delete.

    python examples/python/smarty.py \
    -u "https://smarty.mail.ru/api/v1/persons/delete?oauth_provider=mcs&oauth_token=e50b000614a371ce99c01a80a4558d8ed93b313737363830" \
    --meta '{"space":"1", "images":[{"name":"myname", "person_id":1}]}' \
    -v

    Если запрос верный, ответ будет такой:

    {
    "status":200,
    "body":
    {
    "objects":[{"status":0,"name":"myname"}]
    },
    "htmlencoded":false,
    "last_modified":0
    }

    Для этого запроса не требуется передавать картинку, достаточно только мета-информации c указанием id персоны, которую надо удалить.

    В настоящий момент этот запрос требуется делать с помощью multipart/form"-data, как и предыдущие запросы.

    В будущем планируется возможность вызывать такие запросы (не требующие передачи файла на сервер) через обычный application/json или даже с помощью обычного GET-запроса.

    Полезна ли была эта статья?