Liveness¶

Общие правила чтения полей, причины отказа и форматы файлов full/light описаны в обзоре.

Родитель: liveness_result. Общий блок вариантов проверки живости, включая Head Position, Short, Distance, Distance v2, Pro Max и Core. Состав дополнительных оценок зависит от варианта и реально выполненных проверок.

Поля liveness_result.

Поля с пометкой «Обязателен» присутствуют всегда внутри этого объекта. Остальные поля — при наличии значения; null исключается из ответа.

Поле	Тип в JSON	Назначение и условия
`result`	boolean	Сохранённый результат технологии: `true` — принята, `false` — отрицательный результат. До расчёта может отсутствовать; учитывайте статус и особенности ниже.
`face_photo`	string	Лучший выбранный кадр лица; Base64 в полном ответе, ссылка в light. При наличии фото.
`prediction`	string	Итоговая числовая оценка живости в десятичной записи, сохраняется с 4 знаками после точки.
`face_direction`	string, enum	`forward` — прямо, `right` — вправо, `left` — влево, `not_found` — направление не найдено.
`face_center`	boolean	Лицо находится в центре кадра.
`eye_closed`	boolean	Признак закрытых глаз.
`brightness_score`	number	Оценка освещения.
`brightness_ok`	boolean	Пройдена ли проверка освещения для соответствующей оценки.
`blurriness_score`	number	Оценка размытия выбранного лучшего кадра.
`blurriness_ok`	boolean	Пройдена ли проверка размытия выбранного кадра.
`age`	number	Оценка возраста лица, может быть дробной. Модельная оценка, не возраст из документа.
`gender`	string	Метка пола от модели анализа лица.
`race`	string	Метка категории внешности от модели.
`failure_reason`	object	Причина отказа, если записана; структура.

Статус внутренней обработки Liveness, видео, GIF, детекции и оценки отдельных моделей этим блоком не возвращаются.

Целостные примеры полного и light-ответа с Liveness приведены в обзоре получения результата.