For the complete documentation index, see llms.txt. This page is also available as Markdown.

Правила назначения анализов

Анализы могут быть назначены медиафайлам как вручную пользователем — например, через выбор сценария Liveness в приложении — так и автоматически, когда выбор не производится и пользователь запускает все возможные анализы для папки с медиафайлами.

В последнем случае система автоматически определяет, какие именно анализы должны запускаться для того или иного медиафайла. При этом она исходит из того, какие теги указаны при загрузке файлов. Если файлы загружаются через web-консоль, теги расставляет пользователь, если ведется съемка через SDK — теги проставляются в процессе съемки также автоматически. Также роль играет тип медиафайлов: IMAGE (фото)/VIDEO/SHOTS_SET (приравнивается к видео). Если медиафайл не подходит под требования того или иного анализа, этот анализ такой медиафайл игнорирует.

Список настроек по умолчанию приведен ниже. Для изменения конфигурации, пожалуйста, напишите нам.

Quality (Liveness)

Анализ выполняется для всех медиафайлов вне зависимости от воспроизводимого в них жеста (теги жестов начинаются с video_selfie).

Внимание: в версии API 4.0.8 и ниже, чтобы отправить на анализ Quality (Liveness) изображение, а не видео, необходимо поместить его в архив .zip, установить тип файла SHOTS_SET и поставить один из тегов video_, иначе Quality изображение проигнорирует.

Biometry

Анализ выполняется для всех фото и видео.

Если в папке будет менее двух подходящих медиафайлов, система вернет ошибку. Если более двух, то будут сравниваться все возможные пары, и система выдаст результат по паре с наименьшим сходством.

Collection

Анализ выполняется только при наличии заранее созданного списка-коллекции для всех присутствующих в папке / указанных в качестве источника фото и видео.

Best Shot

Это дополнительная опция к анализу Quality. Анализ выполняется для всех медиафайлов, подходящих для анализа Quality. Соответствующую настройку можно отключить.

Documents

Сверка лица с документами (анализ “Documents”) выполняется для медиафайлов с тегами photo_id_front, photo_id_back (документы) и photo_selfie (селфи). Если таких файлов нет, выбираются файлы без тегов.

Сверка лица с документами (анализ “Documents”) выполняется для медиафайлов по указанным ниже правилам. Правила приведены в соответствии с приоритетом: если медиафайл соответствует более высокому приоритету, правила с приоритетом ниже игнорируются.

  1. Медиафайлы, перечисленные в source_media:

  1. Медиафайлы с тегами photo_id_front, photo_id_back (документы) и photo_selfie (селфи)

  2. Если и в source_media пусто, и нет файлов с указанными тегами, выбирается медиафайл без тегов.

Результат сверки будет положительным, если есть фото лица и хотя бы один валидный документ (с фотографией того же лица) из списка ниже:

  • паспорт

  • водительские права

  • заграничный паспорт

Связанные с тегами ошибки

Код ошибки

Сообщение

Описание

202

Could not locate face on source media [media_id]

Лицо на медиа не найдено. Это может быть результатом неправильно выставленных (например photo_id_back) или отсутствующих тегов

202

Biometry. Analyse requires at least 2 media objects to process

Алгоритмы не нашли хотя бы двух файлов для сравнения. Возможно, найден только один медиафайл или медиафайлам не установлены теги

202

Processing error - did not found any document candidates on image

Документы на прилагаемых медиа не найдены — либо подгружено не фото документа, либо теги подгруженных медиафайлов отсутствуют / некорректны (не содержат photo_id в начале)

400

Can't start analysis without media

Установленные для медифайлов теги не соответствуют требованиям для анализа Documents

5

Invalid/missed tag values to process quality check

Установленные для медиафайлов теги относятся к тем, которые анализ Quality игнорирует (скорее всего, они начинаются с photo_, а не video_*)

5

Invalid/missed tag values to process blacklist check

Установленные для медиафайлов теги не могут быть обработаны алгоритмами Blacklist. Возможно, медиафайлам не установлены теги

Last updated

Was this helpful?