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

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

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

Примечание

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

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

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

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

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

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

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

Пользовательская настройка 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.