findface-extraction-api

Сервис findface-extraction-api использует нейронные сети для обнаружения объектов на изображении, извлечения векторов признаков объектов, распознавания атрибутов объектов (например, цвета одежды для силуэтов).

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

  • Получает от него фотографию с объектом или нормализованное изображение объекта.

  • Возвращает координаты рамки с объектом и, при наличии запроса от findface-sf-api, вектор признаков объекта и данные об его атрибутах.

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

  • детекция (обнаружение) объекта на исходном изображении с возвращением координат рамки с объектом,

  • получение из исходного изображения нормализованного изображения объекта,

  • извлечение из нормализованного изображения объекта вектора признаков (биометрического образца),

  • распознавание атрибутов объекта (пол человека, возраст, эмоции; цвет одежды; цвет автомобиля, модель автомобиля и др.).

Сервис findface-extraction-api может работать с ускорением на CPU (устанавливается из образа docker.int.ntl/ntech/universe/extraction-api-cpu) или GPU (устанавливается из образа docker.int.ntl/ntech/universe/extraction-api-gpu). Как для CPU-, так и для GPU-сервиса, настройка выполняется через файл конфигурации findface-extraction-api.yaml. Вы можете просмотреть его исходное содержимое здесь для CPU, здесь для GPU.

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

Параметр

Описание

detectors → max_batch_size

Верхний предел размера батча для детектора. При использовании CPU можно указать max_batch_size: -1, тогда максимальный размер батча детектора будет соответствовать количеству ядер CPU. По умолчанию 1.

normalizers → max_batch_size

Верхний предел размера батча для нормализатора. При использовании CPU можно указать max_batch_size: -1, тогда максимальный размер батча нормализатора будет соответствовать количеству ядер CPU. По умолчанию 1.

extractors → max_batch_size

Верхний предел размера батча для экстрактора. При использовании CPU можно указать max_batch_size: -1, тогда максимальный размер батча экстрактора будет соответствовать количеству ядер CPU. По умолчанию 1.

detectors → … → min_object_size

Минимальный размер объекта, который будет гарантированно найден. Определяется размером рамки с объектом (bbox). Чем больше значение, тем менее ресурсоемок процесс обнаружения объекта.

gpu_device

(Только для GPU) ID GPU-устройства, используемого findface-extraction-api-gpu.

license_ntls_server

IP-адрес и порт сервера лицензирования findface-ntls.

При необходимости вы также можете включить модели для распознавания атрибутов лица, силуэтов и их атрибутов, транспортных средств и их атрибутов, модели для распознавания liveness лиц:

Важно

Тип ускорения модели (CPU/GPU) должен совпадать с типом ускорения findface-extraction-api. Обратите внимание, что findface-extraction-api на CPU может работать только с CPU-моделями, в то время как findface-extraction-api на GPU поддерживает как GPU-, так и CPU-модели.