findface-sf-api

Сервис findface-sf-api реализует HTTP API для доступа к функциям ядра FindFace, таким как обнаружение (детекция) объектов и распознавание объектов.

Примечание

Сами указанные функции выполняются компонентом findface-extraction-api.

Компонент findface-sf-api взаимодействует со следующими компонентами ядра FindFace:

  • база данных векторов признаков на основе Tarantool через сервис findface-tarantool-server

  • компонент findface-extraction-api, обеспечивающий обнаружение объектов и распознавание объектов

  • компонент findface-upload, отвечающий за хранение исходных изображений и артефактов ядра FindFace core

Для обнаружения объекта на фотографии в компонент findface-sf-api должен быть отправлен API-запрос, передающий данную фотографию в виде файла или URL. Данный запрос затем перенаправляется в компонент findface-extraction-api.

При наличии в системе видеодетектора объектов (присутствует в FindFace Multi) компонент findface-sf-api получает данные об обнаруженных объектах вместе с правилами их обработки от компонента findface-facerouter и затем выполняет полученные директивы (например, сохраняет объекты в определенную галерею базы данных).

Примечание

В FindFace Multi функции findface-facerouter выполняет сервис findface-security.

Полный список функций:

  • HTTP API по части обнаружения и распознавания объектов (сами операции выполняются findface-extraction-api).

  • сохранение объектов в базу данных векторов признаков (через сервис findface-tarantool-server),

  • сохранение исходных изображений, миниатюр и нормализованных изображений объектов на веб-сервере nginx (через сервис findface-upload).

  • обеспечение взаимодействия всех компонентов системы.

Настройка компонента findface-sf-api выполняется через файл конфигурации /etc/findface-sf-api.ini. Вы можете просмотреть его исходное содержимое здесь.

Пользовательская настройка findface-sf-api выполняется с использованием следующих параметров:

Параметр

Описание

extraction-api -> extraction-api

IP-адрес и порт сервера findface-extraction-api.

limits -> body-image-length

Максимальный размер в байтах изображения, передаваемого через API-запрос.

normalized-storage -> webdav ->

upload_url

Путь в WebDAV nginx, по которому в компонент findface-upload будут отправляться исходные изображения, миниатюры и нормализованные изображения объектов.

storage-api -> shards -> master

IP-адрес физического сервера с мастером шарда findface-tarantool-server.

storage-api -> shards -> slave

IP-адрес физического сервера с репликой шарда findface-tarantool-server.