index-faces

Описание

Обнаруживает лица на входном изображении и добавляет их в указанную коллекцию.

Amazon Rekognition не сохраняет фактические лица, которые были обнаружены. Вместо этого, лежащий в основе алгоритм обнаружения сначала обнаруживает лица на входном изображении. Для каждого лица алгоритм извлекает черты лица в вектор признаков и сохраняет его в базе данных бэкэнда. Amazon Rekognition использует векторы признаков при выполнении операций сопоставления и поиска лиц с помощью операций SearchFaces и SearchFacesByImage.

Дополнительную информацию можно найти в разделе «Добавление лиц в коллекцию» в руководстве разработчика Amazon Rekognition.

Чтобы получить количество лиц в коллекции, вызовите DescribeCollection.

Если вы используете версию 1.0 модели обнаружения лиц, IndexFaces индексирует 15 крупнейших лиц на входном изображении. Более поздние версии модели обнаружения лиц индексируют 100 крупнейших лиц на входном изображении.

Если вы используете версию 4 или более позднюю модели лица, информация об ориентации изображения не возвращается в поле OrientationCorrection.

Чтобы определить, какую версию модели вы используете, вызовите DescribeCollection и укажите идентификатор коллекции. Вы также можете получить версию модели из значения FaceModelVersion в ответе от IndexFaces

Дополнительную информацию см. в разделе «Версии моделей» в руководстве разработчика Amazon Rekognition.

Если вы предоставите необязательный ExternalImageId для входного изображения, Amazon Rekognition связывает этот идентификатор со всеми обнаруженными лицами. При вызове операции ListFaces ответ возвращает внешний идентификатор. Вы можете использовать этот внешний идентификатор изображения для создания клиентского индекса для сопоставления лиц с каждым изображением. Затем вы можете использовать индекс для поиска всех лиц на изображении.

Вы можете указать максимальное количество индексируемых лиц с помощью входного параметра MaxFaces. Это полезно, когда вы хотите индексировать самые большие лица на изображении и не хотите индексировать меньшие лица, такие как лица людей, стоящих на заднем плане.

Входной параметр QualityFilter позволяет отфильтровать обнаруженные лица, которые не соответствуют требуемому качеству. Критерий качества основан на различных распространенных сценариях использования. По умолчанию IndexFaces выбирает критерий качества, используемый для фильтрации лиц. Вы также можете явно выбрать критерий качества. Используйте QualityFilter, чтобы установить критерий качества, указав LOW, MEDIUM или HIGH. Если вы не хотите фильтровать обнаруженные лица, укажите NONE.

Примечание

Для использования фильтрации по качеству вам необходима коллекция, связанная с версией 3 или более поздней модели лица. Чтобы получить версию модели лица, связанную с коллекцией, вызовите DescribeCollection.

Информация о лицах, обнаруженных на изображении, но не индексированных, возвращается в массиве объектов UnindexedFace, UnindexedFaces. Лица не индексируются по причинам, таким как:

Количество обнаруженных лиц превышает значение параметра запроса MaxFaces.
Лицо слишком мало по сравнению с размерами изображения.
Лицо слишком размыто.
Изображение слишком темное.
Лицо имеет слишком экстремальную позу.
Лицо не имеет достаточно деталей, чтобы быть подходящим для поиска лиц.

В ответ операция IndexFaces возвращает массив метаданных для всех обнаруженных лиц, FaceRecords. Это включает:

Прямоугольник, BoundingBox, обнаруженного лица.
Значение уверенности, Confidence, которое указывает уверенность в том, что прямоугольник содержит лицо.
Идентификатор лица, FaceId, назначенный службой для каждого обнаруженного и сохраненного лица.
Идентификатор изображения, ImageId, назначенный службой для входного изображения.

Если вы запрашиваете ALL или определенные атрибуты лица (например, FACE_OCCLUDED) с помощью параметра detectionAttributes, Amazon Rekognition возвращает подробные атрибуты лица, такие как точки опорных очков (например, расположение глаз и рта), части лица, закрытые предметами, и другие атрибуты лица.

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

Входное изображение передаётся либо в виде base64-кодированных байтов изображения, либо как ссылка на изображение в бакете Amazon S3. Если вы используете AWS CLI для вызова операций Amazon Rekognition, передача байтов изображения в base64-кодированном формате не поддерживается. Изображение должно быть отформатировано как файл PNG или JPEG.

Для этой операции необходимы разрешения на выполнение действия rekognition:IndexFaces.

См. также: AWS API Documentation

Синопсис

  index-faces
--collection-id <value>
[--image <value>]
[--external-image-id <value>]
[--detection-attributes <value>]
[--max-faces <value>]
[--quality-filter <value>]
[--image-bytes <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--collection-id (строка)

Идентификатор существующей коллекции, в которую вы хотите добавить обнаруженные на входных изображениях лица.

--image (структура)

Входное изображение в виде base64-кодированных байтов или объекта S3. Если вы используете AWS CLI для вызова операций Amazon Rekognition, передача base64-кодированных байтов изображения не поддерживается.

Если вы используете AWS SDK для вызова операций Amazon Rekognition, вам может не потребоваться base64-кодировать байты изображения, передаваемые с помощью поля Bytes. Дополнительную информацию см. в руководстве разработчика Amazon Rekognition в разделе «Изображения».

Для указания локального файла используйте --image-bytes вместо этого.

Байты -> (двоичные данные)

Двоичные данные изображения размером до 5 МБ. Обратите внимание, что максимальный размер изображения, который вы можете передать в DetectCustomLabels, составляет 4 МБ.

S3Object -> (структура)

Идентифицирует объект S3 в качестве источника изображения.

Bucket -> (строка)

Имя бакета S3.

Name -> (строка)

Имя ключа объекта S3.

Version -> (строка)

Если версия бакета включена, вы можете указать версию объекта.

Сокращенная синтаксис:

Bytes=blob,S3Object={Bucket=string,Name=string,Version=string}

Синтаксис JSON:

{
  "Bytes": blob,
  "S3Object": {
    "Bucket": "string",
    "Name": "string",
    "Version": "string"
  }
}

--external-image-id (строка)

Идентификатор, который вы хотите назначить всем обнаруженным на изображении лицам.

--detection-attributes (список)

Массив атрибутов лица, которые вы хотите получить. Подмножество атрибутов лица - DEFAULT, BoundingBox, Confidence, Pose и Quality - всегда будут возвращены. Вы можете запросить определенные атрибуты лица (в дополнение к списку по умолчанию) - используя ["DEFAULT", "FACE_OCCLUDED"] или просто ["FACE_OCCLUDED"]. Вы можете запросить все атрибуты лица, используя ["ALL"]. Запрос дополнительных атрибутов может увеличить время ответа.

Если вы предоставите оба, ["ALL", "DEFAULT"], служба использует логический оператор И для определения атрибутов, которые необходимо вернуть (в этом случае все атрибуты).

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  DEFAULT
  ALL
  AGE_RANGE
  BEARD
  EMOTIONS
  EYE_DIRECTION
  EYEGLASSES
  EYES_OPEN
  GENDER
  MOUTH_OPEN
  MUSTACHE
  FACE_OCCLUDED
  SMILE
  SUNGLASSES

--max-faces (целое число)

Максимальное количество индексируемых лиц. Значение MaxFaces должно быть больше или равно 1. IndexFaces возвращает не более 100 обнаруженных лиц на изображении, даже если вы укажете большее значение для MaxFaces.

Если IndexFaces обнаружит больше лиц, чем значение MaxFaces, лица с наименьшим качеством отфильтровываются в первую очередь. Если всё ещё остается больше лиц, чем значение MaxFaces, лица с наименьшими прямоугольниками отфильтровываются (до необходимого числа для удовлетворения значения MaxFaces). Информация о неиндексированных лицах доступна в массиве UnindexedFaces.

Лица, которые возвращаются IndexFaces, сортируются по размеру прямоугольника с наибольшего лица к наименьшему размеру, в порядке убывания.

MaxFaces может использоваться с коллекцией, связанной с любой версией модели лица.

--quality-filter (строка)

Фильтр, который задает критерий качества для степени фильтрации для идентификации лиц. Отфильтрованные лица не индексируются. Если вы укажите AUTO, Amazon Rekognition выбирает критерий качества. Если вы укажите LOW, MEDIUM или HIGH, фильтрация удаляет все лица, которые не соответствуют выбранному критерию качества. Значение по умолчанию - AUTO. Критерий качества основан на различных распространенных сценариях использования. Обнаружения низкого качества могут происходить по нескольким причинам. Некоторые примеры - это объект, ошибочно идентифицированный как лицо, лицо, которое слишком размыто, или лицо с слишком экстремальной позой для использования. Если вы укажите NONE, фильтрация не выполняется.

Для использования фильтрации по качеству используемая вами коллекция должна быть связана с версией 3 или более поздней модели лица.

Возможные значения:

NONE
AUTO
LOW
MEDIUM
HIGH

--image-bytes (двоичные данные)

Содержимое изображения для загрузки. Для указания содержимого локального файла используйте префикс fileb://. Пример: fileb://image.png

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса к API. Если указано без значения или со значением input, выводит пример входного JSON, который может использоваться в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет образец входного YAML, который может использоваться с --cli-input-yaml. Если указано со значением output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном каркасе JSON.

Общие параметры

--debug (boolean)

Включить отладочную запись в журнал.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использование определенного профиля из файла учетных данных.

--region (string)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (string)

Отображение версии этого инструмента.

--color (string)

Включение/выключение цветного вывода.

on
off
auto

--no-sign-request (boolean)

Отключить подписание запросов. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, а двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку fileb://, всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, характерные для Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. использование кавычек со строками в Руководстве пользователя AWS CLI.

Добавление лиц в коллекцию

Следующая команда index-faces добавляет лица, обнаруженные на изображении, в указанную коллекцию.

aws rekognition index-faces \
    --image '{"S3Object":{"Bucket":"MyVideoS3Bucket","Name":"MyPicture.jpg"}}' \
    --collection-id MyCollection \
    --max-faces 1 \
    --quality-filter "AUTO" \
    --detection-attributes "ALL" \
    --external-image-id "MyPicture.jpg"

Вывод:

{
    "FaceRecords": [
        {
            "FaceDetail": {
                "Confidence": 99.993408203125,
                "Eyeglasses": {
                    "Confidence": 99.11750030517578,
                    "Value": false
                },
                "Sunglasses": {
                    "Confidence": 99.98249053955078,
                    "Value": false
                },
                "Gender": {
                    "Confidence": 99.92769622802734,
                    "Value": "Male"
                },
                "Landmarks": [
                    {
                        "Y": 0.26750367879867554,
                        "X": 0.6202793717384338,
                        "Type": "eyeLeft"
                    },
                    {
                        "Y": 0.26642778515815735,
                        "X": 0.6787431836128235,
                        "Type": "eyeRight"
                    },
                    {
                        "Y": 0.31361380219459534,
                        "X": 0.6421601176261902,
                        "Type": "nose"
                    },
                    {
                        "Y": 0.3495299220085144,
                        "X": 0.6216195225715637,
                        "Type": "mouthLeft"
                    },
                    {
                        "Y": 0.35194727778434753,
                        "X": 0.669899046421051,
                        "Type": "mouthRight"
                    },
                    {
                        "Y": 0.26844894886016846,
                        "X": 0.6210268139839172,
                        "Type": "leftPupil"
                    },
                    {
                        "Y": 0.26707562804222107,
                        "X": 0.6817160844802856,
                        "Type": "rightPupil"
                    },
                    {
                        "Y": 0.24834522604942322,
                        "X": 0.6018546223640442,
                        "Type": "leftEyeBrowLeft"
                    },
                    {
                        "Y": 0.24397172033786774,
                        "X": 0.6172008514404297,
                        "Type": "leftEyeBrowUp"
                    },
                    {
                        "Y": 0.24677404761314392,
                        "X": 0.6339119076728821,
                        "Type": "leftEyeBrowRight"
                    },
                    {
                        "Y": 0.24582654237747192,
                        "X": 0.6619398593902588,
                        "Type": "rightEyeBrowLeft"
                    },
                    {
                        "Y": 0.23973053693771362,
                        "X": 0.6804757118225098,
                        "Type": "rightEyeBrowUp"
                    },
                    {
                        "Y": 0.24441994726657867,
                        "X": 0.6978968977928162,
                        "Type": "rightEyeBrowRight"
                    },
                    {
                        "Y": 0.2695908546447754,
                        "X": 0.6085202693939209,
                        "Type": "leftEyeLeft"
                    },
                    {
                        "Y": 0.26716896891593933,
                        "X": 0.6315826177597046,
                        "Type": "leftEyeRight"
                    },
                    {
                        "Y": 0.26289820671081543,
                        "X": 0.6202316880226135,
                        "Type": "leftEyeUp"
                    },
                    {
                        "Y": 0.27123287320137024,
                        "X": 0.6205548048019409,
                        "Type": "leftEyeDown"
                    },
                    {
                        "Y": 0.2668408751487732,
                        "X": 0.6663622260093689,
                        "Type": "rightEyeLeft"
                    },
                    {
                        "Y": 0.26741549372673035,
                        "X": 0.6910083889961243,
                        "Type": "rightEyeRight"
                    },
                    {
                        "Y": 0.2614026665687561,
                        "X": 0.6785826086997986,
                        "Type": "rightEyeUp"
                    },
                    {
                        "Y": 0.27075251936912537,
                        "X": 0.6789616942405701,
                        "Type": "rightEyeDown"
                    },
                    {
                        "Y": 0.3211299479007721,
                        "X": 0.6324167847633362,
                        "Type": "noseLeft"
                    },
                    {
                        "Y": 0.32276326417922974,
                        "X": 0.6558475494384766,
                        "Type": "noseRight"
                    },
                    {
                        "Y": 0.34385165572166443,
                        "X": 0.6444970965385437,
                        "Type": "mouthUp"
                    },
                    {
                        "Y": 0.3671635091304779,
                        "X": 0.6459195017814636,
                        "Type": "mouthDown"
                    }
                ],
                "Pose": {
                    "Yaw": -9.54541015625,
                    "Roll": -0.5709401965141296,
                    "Pitch": 0.6045494675636292
                },
                "Emotions": [
                    {
                        "Confidence": 39.90074157714844,
                        "Type": "HAPPY"
                    },
                    {
                        "Confidence": 23.38753890991211,
                        "Type": "CALM"
                    },
                    {
                        "Confidence": 5.840933322906494,
                        "Type": "CONFUSED"
                    }
                ],
                "AgeRange": {
                    "High": 63,
                    "Low": 45
                },
                "EyesOpen": {
                    "Confidence": 99.80887603759766,
                    "Value": true
                },
                "BoundingBox": {
                    "Width": 0.18562500178813934,
                    "Top": 0.1618015021085739,
                    "Left": 0.5575000047683716,
                    "Height": 0.24770642817020416
                },
                "Smile": {
                    "Confidence": 99.69740295410156,
                    "Value": false
                },
                "MouthOpen": {
                    "Confidence": 99.97393798828125,
                    "Value": false
                },
                "Quality": {
                    "Sharpness": 95.54405975341797,
                    "Brightness": 63.867706298828125
                },
                "Mustache": {
                    "Confidence": 97.05007934570312,
                    "Value": false
                },
                "Beard": {
                    "Confidence": 87.34505462646484,
                    "Value": false
                }
            },
            "Face": {
                "BoundingBox": {
                    "Width": 0.18562500178813934,
                    "Top": 0.1618015021085739,
                    "Left": 0.5575000047683716,
                    "Height": 0.24770642817020416
                },
                "FaceId": "ce7ed422-2132-4a11-ab14-06c5c410f29f",
                "ExternalImageId": "example-image.jpg",
                "Confidence": 99.993408203125,
                "ImageId": "8d67061e-90d2-598f-9fbd-29c8497039c0"
            }
        }
    ],
    "UnindexedFaces": [],
    "FaceModelVersion": "3.0",
    "OrientationCorrection": "ROTATE_0"
}

Дополнительную информацию см. в разделе Добавление лиц в коллекцию в Руководстве разработчика Amazon Rekognition.

Вывод

FaceRecords -> (список)

Массив лиц, обнаруженных и добавленных в коллекцию. Дополнительную информацию см. в разделе Поиск лиц в коллекции в руководстве разработчика Amazon Rekognition.

(структура)

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

Face -> (структура)

Описывает свойства лица, такие как рамка, идентификатор лица, идентификатор изображения входного изображения и внешний идентификатор изображения, который вы назначили.

FaceId -> (строка)

Уникальный идентификатор, назначенный Amazon Rekognition лицу.

BoundingBox -> (структура)

Рамка лица.

Width -> (вещественное число)

Ширина рамки как отношение к общей ширине изображения.

Height -> (вещественное число)

Высота рамки как отношение к общей высоте изображения.

Left -> (вещественное число)

Левая координата рамки как отношение к общей ширине изображения.

Top -> (вещественное число)

Верхняя координата рамки как отношение к общей высоте изображения.

ImageId -> (строка)

Уникальный идентификатор, назначенный Amazon Rekognition входному изображению.

ExternalImageId -> (строка)

Идентификатор, который вы назначили всем лицам на входном изображении.

Confidence -> (вещественное число)

Уровень уверенности в том, что рамка содержит лицо (а не другой объект, например, дерево).

IndexFacesModelVersion -> (строка)

Версия модели распознавания и хранения лиц, которая использовалась при индексировании векторных данных лица.

UserId -> (строка)

Уникальный идентификатор, назначенный пользователю.

FaceDetail -> (структура)

Структура, содержащая атрибуты лица, обнаруженные алгоритмом.

BoundingBox -> (структура)

Рамка лица. Атрибут по умолчанию.

Width -> (вещественное число)

Ширина рамки как отношение к общей ширине изображения.

Height -> (вещественное число)

Высота рамки как отношение к общей высоте изображения.

Left -> (вещественное число)

Левая координата рамки как отношение к общей ширине изображения.

Top -> (вещественное число)

Верхняя координата рамки как отношение к общей высоте изображения.

AgeRange -> (структура)

Оценённый диапазон возраста лица в годах. Low соответствует минимальному, а High - максимальному предполагаемому возрасту.

Low -> (целое число)

Минимальный предполагаемый возраст.

High -> (целое число)

Максимальный предполагаемый возраст.

Smile -> (структура)

Указывает, улыбается ли лицо, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, улыбается ли лицо.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Eyeglasses -> (структура)

Указывает, носит ли лицо очки, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, носит ли лицо очки.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Sunglasses -> (структура)

Указывает, носит ли лицо солнцезащитные очки, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, носит ли лицо солнцезащитные очки.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Gender -> (структура)

Предсказанный пол обнаруженного лица.

Value -> (строка)

Предсказанный пол лица.

Confidence -> (вещественное число)

Уровень уверенности в прогнозе.

Beard -> (структура)

Указывает, есть ли у лица борода, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, есть ли у лица борода.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Mustache -> (структура)

Указывает, есть ли у лица усы, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, есть ли у лица усы.

Confidence -> (вещественное число)

Уровень уверенности в определении.

EyesOpen -> (структура)

Указывает, открыты ли глаза на лице, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, открыты ли глаза на лице.

Confidence -> (вещественное число)

Уровень уверенности в определении.

MouthOpen -> (структура)

Указывает, открыт ли рот на лице, и уровень уверенности в этом определении.

Value -> (булево)

Булево значение, указывающее, открыт ли рот на лице.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Emotions -> (список)

Эмоции, которые, как кажется, выражает лицо, и уровень уверенности в этом определении. API определяет только внешнее выражение лица. Это не оценка внутреннего эмоционального состояния и не должно использоваться таким образом. Например, человек, делающий вид, что грустный, может на самом деле не быть грустным.

(структура)

Type -> (строка)

Тип обнаруженной эмоции.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Landmarks -> (список)

Указывает расположение отметок на лице. Атрибут по умолчанию.

(структура)

Указывает расположение отметки на лице.

Type -> (строка)

Тип отметки.

X -> (вещественное число)

Координата x отметки, выраженная как отношение к ширине изображения. Координата x измеряется слева от изображения. Например, если ширина изображения составляет 700 пикселей, а координата x отметки находится в 350 пикселях, значение равно 0,5.

Y -> (вещественное число)

Координата y отметки, выраженная как отношение к высоте изображения. Координата y измеряется сверху от изображения. Например, если высота изображения составляет 200 пикселей, а координата y отметки находится в 50 пикселях, значение равно 0,25.

Pose -> (структура)

Указывает позу лица, определяемую углом наклона, поворотом и вращением. Атрибут по умолчанию.

Roll -> (вещественное число)

Значение, представляющее поворот лица вокруг оси вращения.

Yaw -> (вещественное число)

Значение, представляющее поворот лица вокруг оси вращения.

Pitch -> (вещественное число)

Значение, представляющее поворот лица вокруг оси наклона.

Quality -> (структура)

Определяет яркость и резкость изображения. Атрибут по умолчанию.

Brightness -> (вещественное число)

Значение, представляющее яркость лица. Сервис возвращает значение от 0 до 100 (включительно). Большее значение указывает на более яркое изображение лица.

Sharpness -> (вещественное число)

Значение, представляющее резкость лица. Сервис возвращает значение от 0 до 100 (включительно). Большее значение указывает на более резкое изображение лица.

Confidence -> (вещественное число)

Уровень уверенности в том, что рамка содержит лицо (а не другой объект, например, дерево). Атрибут по умолчанию.

FaceOccluded -> (структура)

FaceOccluded должно возвращать «true» с высоким уровнем уверенности, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, телефонами, руками или другими предметами. FaceOccluded должно возвращать «false» с высоким уровнем уверенности, если обнаружены распространённые случаи, не влияющие на проверку лица, такие как очки, лёгкие тонированные солнцезащитные очки, пряди волос и другие.

Value -> (булево)

True, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, телефонами, руками или другими предметами. False, если обнаружены распространённые случаи, не влияющие на проверку лица, такие как очки, лёгкие тонированные солнцезащитные очки, пряди волос и другие.

Confidence -> (вещественное число)

Уверенность сервиса в обнаружении частичного закрытия лица.

EyeDirection -> (структура)

Указывает направление взгляда глаз, определённое углом наклона и вращением.

Yaw -> (вещественное число)

Значение, представляющее направление взгляда глаз по оси вращения.

Pitch -> (вещественное число)

Значение, представляющее направление взгляда глаз по оси наклона.

Confidence -> (вещественное число)

Уверенность сервиса в предсказанном направлении взгляда глаз.

OrientationCorrection -> (строка)

Если ваша коллекция связана с моделью распознавания лиц, более поздней версии 3.0, значение OrientationCorrection всегда равно null, и информация об ориентации не возвращается.

Если ваша коллекция связана с моделью распознавания лиц версии 3.0 или более ранней, применяется следующее:

Если входное изображение в формате .jpeg, оно может содержать метаданные формата обмена изображениями (Exif), включающие ориентацию изображения. Amazon Rekognition использует эту информацию об ориентации для коррекции изображения — координаты рамки преобразуются для отображения местоположения объекта после использования информации об ориентации в метаданных Exif для коррекции ориентации изображения. Изображения в формате .png не содержат метаданных Exif. Значение OrientationCorrection равно null.
Если изображение не содержит информации об ориентации в метаданных Exif, Amazon Rekognition возвращает оценённую ориентацию (ROTATE_0, ROTATE_90, ROTATE_180, ROTATE_270). Amazon Rekognition не выполняет коррекцию изображения для изображений. Координаты рамки не преобразуются и представляют местоположение объекта до поворота изображения.

Информация о рамке возвращается в массиве FaceRecords. Вы можете получить версию модели распознавания лиц, вызвав DescribeCollection.

FaceModelVersion -> (строка)

Номер версии модели распознавания лиц, связанной с входной коллекцией (CollectionId).

UnindexedFaces -> (список)

Массив лиц, которые были обнаружены на изображении, но не были проиндексированы. Они не были проиндексированы, потому что фильтр качества определил их как низкого качества, или параметр запроса MaxFaces отфильтровал их. Для использования фильтра качества, вы указываете параметр запроса QualityFilter.

(структура)

Лицо, которое IndexFaces обнаружил, но не проиндексировал. Используйте атрибут ответа Reasons, чтобы определить, почему лицо не было проиндексировано.

Причины -> (список)

Массив причин, которые указывают, почему лицо не было проиндексировано.

EXTREME_POSE - Лицо находится в такой позе, которую невозможно определить. Например, голова повернута слишком сильно от камеры.
EXCEEDS_MAX_FACES - Количество обнаруженных лиц уже выше, чем указано в параметре входных данных MaxFaces для IndexFaces.
LOW_BRIGHTNESS - Изображение слишком тёмное.
LOW_SHARPNESS - Изображение слишком размытое.
LOW_CONFIDENCE - Лицо было обнаружено с низкой уверенностью.
SMALL_BOUNDING_BOX - Граница вокруг лица слишком маленькая.

(строка)

FaceDetail -> (структура)

Структура, содержащая атрибуты лица, которое IndexFaces обнаружил, но не проиндексировал.

BoundingBox -> (структура)

Прямоугольная область лица. Атрибут по умолчанию.

Width -> (вещественное число)

Ширина прямоугольной области как отношение к общей ширине изображения.

Height -> (вещественное число)

Высота прямоугольной области как отношение к общей высоте изображения.

Left -> (вещественное число)

Координата слева прямоугольной области как отношение к общей ширине изображения.

Top -> (вещественное число)

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

AgeRange -> (структура)

Оценённый диапазон возраста лица в годах. Low — минимальный, High — максимальный возраст.

Low -> (целое число)

Минимальный оценённый возраст.

High -> (целое число)

Максимальный оценённый возраст.

Smile -> (структура)

Указывает, улыбается ли лицо, и уровень уверенности в определении.

Value -> (булево)

Булевое значение, указывающее, улыбается ли лицо.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Eyeglasses -> (структура)

Указывает, носит ли лицо очки, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, носит ли лицо очки.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Sunglasses -> (структура)

Указывает, носит ли лицо солнцезащитные очки, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, носит ли лицо солнцезащитные очки.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Gender -> (структура)

Предсказанный пол обнаруженного лица.

Value -> (строка)

Предсказанный пол лица.

Confidence -> (вещественное число)

Уровень уверенности в предсказании.

Beard -> (структура)

Указывает, есть ли у лица борода, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, есть ли у лица борода.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Mustache -> (структура)

Указывает, есть ли у лица усы, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, есть ли у лица усы.

Confidence -> (вещественное число)

Уровень уверенности в определении.

EyesOpen -> (структура)

Указывает, открыты ли глаза на лице, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, открыты ли глаза на лице.

Confidence -> (вещественное число)

Уровень уверенности в определении.

MouthOpen -> (структура)

Указывает, открыт ли рот на лице, и уровень уверенности в определении.

Value -> (булево)

Булево значение, указывающее, открыт ли рот на лице.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Emotions -> (список)

Эмоции, которые, по-видимому, выражены на лице, и уровень уверенности в определении. API определяет только физическое выражение лица. Это не определение внутреннего эмоционального состояния человека и не должно использоваться таким образом. Например, человек, изображающий грустное лицо, может на самом деле не испытывать грусть.

(структура)

Type -> (строка)

Тип обнаруженной эмоции.

Confidence -> (вещественное число)

Уровень уверенности в определении.

Landmarks -> (список)

Указывает расположение ориентиров на лице. Атрибут по умолчанию.

(структура)

Указывает расположение ориентира на лице.

Type -> (строка)

Тип ориентира.

X -> (вещественное число)

Координата x ориентира, выраженная как отношение к ширине изображения. Координата x измеряется от левой стороны изображения. Например, если изображение имеет ширину 700 пикселей, а координата x ориентира находится на 350 пикселях, это значение равно 0,5.

Y -> (вещественное число)

Координата y ориентира, выраженная как отношение к высоте изображения. Координата y измеряется сверху изображения. Например, если высота изображения составляет 200 пикселей, а координата y ориентира находится на 50 пикселях, это значение равно 0,25.

Pose -> (структура)

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

Roll -> (вещественное число)

Значение, представляющее поворот лица вокруг оси тангажа.

Yaw -> (вещественное число)

Значение, представляющее поворот лица вокруг оси рыскания.

Pitch -> (вещественное число)

Значение, представляющее поворот лица вокруг оси наклона.

Quality -> (структура)

Определяет яркость и резкость изображения. Атрибут по умолчанию.

Brightness -> (вещественное число)

Значение, представляющее яркость лица. Сервис возвращает значение от 0 до 100 (включительно). Более высокое значение указывает на более яркое изображение лица.

Sharpness -> (вещественное число)

Значение, представляющее резкость лица. Сервис возвращает значение от 0 до 100 (включительно). Более высокое значение указывает на более резкое изображение лица.

Confidence -> (вещественное число)

Уровень уверенности в том, что прямоугольная область содержит лицо, а не другой объект, например, дерево. Атрибут по умолчанию.

FaceOccluded -> (структура)

FaceOccluded должно возвращать «true» с высоким баллом уверенности, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, телефонами, руками или другими объектами. FaceOccluded должно возвращать «false» с высоким баллом уверенности, если обнаружены обычные случаи, которые не влияют на проверку лица, такие как очки, слегка затемнённые солнцезащитные очки, пряди волос и другие.

Value -> (булево)

True, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, телефонами, руками или другими объектами. False, если обнаружены обычные случаи, которые не влияют на проверку лица, такие как очки, слегка затемнённые солнцезащитные очки, пряди волос и другие.

Confidence -> (вещественное число)

Уверенность службы в обнаружении наложения на лицо.

EyeDirection -> (структура)

Указывает направление взгляда глаз, определённое по углу наклона и рысканию.

Yaw -> (вещественное число)

Значение, представляющее направление взгляда глаз по оси рыскания.

Pitch -> (вещественное число)

Значение, представляющее направление взгляда глаз по оси наклона.

Confidence -> (вещественное число)

Уверенность службы в предсказанном направлении взгляда глаз.