[ aws . rekognition ]
get-face-search
Описание
Получает результаты поиска лиц для Amazon Rekognition Video, начатого методом StartFaceSearch. Поиск возвращает лица в коллекции, соответствующие лицам людей, обнаруженным в видео. Он также включает время(а), когда лица сопоставляются в видео.
Поиск лиц в видео — асинхронная операция. Вы запускаете поиск лиц, вызвав StartFaceSearch, который возвращает идентификатор задания (JobId). Когда операция поиска завершается, Amazon Rekognition Video публикует статус завершения в тему Amazon Simple Notification Service, зарегистрированную в первоначальном вызове к StartFaceSearch. Чтобы получить результаты поиска, сначала проверьте, что значение статуса, опубликованное в теме Amazon SNS, равно SUCCEEDED. В таком случае вызовите GetFaceSearch и передайте идентификатор задания (JobId) из первоначального вызова к StartFaceSearch.
Дополнительную информацию см. в разделе Поиск лиц в коллекции в руководстве разработчика Amazon Rekognition.
Результаты поиска возвращаются в массиве, Persons, объектов PersonMatch. Каждый элемент ``PersonMatch`` содержит подробности о сопоставленных лицах в входной коллекции, информацию о человеке (атрибуты лица, рамки и идентификатор человека) для сопоставленного человека и время, когда человек был сопоставлен в видео.
Примечание
GetFaceSearch возвращает только стандартные атрибуты лица (BoundingBox, Confidence, Landmarks, Pose и Quality). Другие атрибуты лица, перечисленные в объекте Face в следующем синтаксисе ответа, не возвращаются. Дополнительную информацию см. в разделе FaceDetail в руководстве разработчика Amazon Rekognition.По умолчанию массив Persons сортируется по времени (в миллисекундах с начала видео), когда люди были сопоставлены. Также можно отсортировать по людям, указав INDEX для параметра ввода SORTBY.
См. также: Документация API AWS
Синтаксис
get-face-search
--job-id <value>
[--max-results <value>]
[--next-token <value>]
[--sort-by <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]
Параметры
--job-id (строка)
StartFaceSearch.--max-results (целое число)
--next-token (строка)
--sort-by (строка)
Сортировка для группировки лиц в ответе. Используйте TIMESTAMP для группировки лиц по времени распознавания. Используйте INDEX для сортировки по распознанным лицам.
Возможные значения:
INDEXTIMESTAMP
--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 (булево)
Включить отладку.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.
--no-paginate (булево)
Отключить автоматическую постраничную обработку. Если автоматическая постраничная обработка отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (булево)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл-сборник сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию равно 60 секундам.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию равно 60 секундам.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображаемого как двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить кли-пейджер для вывода.
--cli-auto-prompt (булево)
Автоматически запросить параметры CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров CLI.
Примеры
Примечание
Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с AWS CLI в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных оболочек. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Получение результатов операции поиска лиц
Следующая get-face-search команда отображает результаты операции поиска лиц, которую вы ранее запустили, вызвав start-face-search.
aws rekognition get-face-search \
--job-id 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
Вывод:
{
"Persons": [
{
"Timestamp": 467,
"FaceMatches": [],
"Person": {
"Index": 0,
"Face": {
"BoundingBox": {
"Width": 0.1560753583908081,
"Top": 0.13555361330509186,
"Left": -0.0952017530798912,
"Height": 0.6934483051300049
},
"Landmarks": [
{
"Y": 0.4013825058937073,
"X": -0.041750285774469376,
"Type": "eyeLeft"
},
{
"Y": 0.41695496439933777,
"X": 0.027979329228401184,
"Type": "eyeRight"
},
{
"Y": 0.6375303268432617,
"X": -0.04034662991762161,
"Type": "mouthLeft"
},
{
"Y": 0.6497718691825867,
"X": 0.013960429467260838,
"Type": "mouthRight"
},
{
"Y": 0.5238034129142761,
"X": 0.008022055961191654,
"Type": "nose"
}
],
"Pose": {
"Yaw": -58.07863998413086,
"Roll": 1.9384294748306274,
"Pitch": -24.66305160522461
},
"Quality": {
"Sharpness": 83.14741516113281,
"Brightness": 25.75942611694336
},
"Confidence": 87.7622299194336
}
}
},
{
"Timestamp": 967,
"FaceMatches": [
{
"Face": {
"BoundingBox": {
"Width": 0.12368900328874588,
"Top": 0.16007399559020996,
"Left": 0.5901259779930115,
"Height": 0.2514039874076843
},
"FaceId": "056a95fa-2060-4159-9cab-7ed4daa030fa",
"ExternalImageId": "image3.jpg",
"Confidence": 100.0,
"ImageId": "08f8a078-8929-37fd-8e8f-aadf690e8232"
},
"Similarity": 98.44476318359375
}
],
"Person": {
"Index": 1,
"Face": {
"BoundingBox": {
"Width": 0.28559377789497375,
"Top": 0.19436298310756683,
"Left": 0.024553587660193443,
"Height": 0.7216082215309143
},
"Landmarks": [
{
"Y": 0.4650231599807739,
"X": 0.16269078850746155,
"Type": "eyeLeft"
},
{
"Y": 0.4843238294124603,
"X": 0.2782580852508545,
"Type": "eyeRight"
},
{
"Y": 0.71530681848526,
"X": 0.1741468608379364,
"Type": "mouthLeft"
},
{
"Y": 0.7310671210289001,
"X": 0.26857468485832214,
"Type": "mouthRight"
},
{
"Y": 0.582602322101593,
"X": 0.2566150426864624,
"Type": "nose"
}
],
"Pose": {
"Yaw": 11.487052917480469,
"Roll": 5.074230670928955,
"Pitch": 15.396159172058105
},
"Quality": {
"Sharpness": 73.32209777832031,
"Brightness": 54.96497344970703
},
"Confidence": 99.99998474121094
}
}
}
],
"NextToken": "5bkgcezyuaqhtWk3C8OTW6cjRghrwV9XDMivm5B3MXm+Lv6G+L+GejyFHPhoNa/ldXIC4c/d",
"JobStatus": "SUCCEEDED",
"VideoMetadata": {
"Format": "QuickTime / MOV",
"FrameRate": 29.970617294311523,
"Codec": "h264",
"DurationMillis": 6806,
"FrameHeight": 1080,
"FrameWidth": 1920
}
}
Дополнительную информацию см. в разделе Поиск лиц в сохранённых видео в Руководстве разработчика Amazon Rekognition.
Вывод
JobStatus -> (строка)
StatusMessage -> (строка)
StatusMessage предоставляет подробное сообщение об ошибке.NextToken -> (строка)
VideoMetadata -> (структура)
Информация о видео, проанализированном Amazon Rekognition. Videometadata возвращается на каждой странице постраничных ответов от операции Amazon Rekognition Video.
Codec -> (строка)
DurationMillis -> (длинное целое число)
Format -> (строка)
FrameRate -> (вещественное число)
FrameHeight -> (длинное целое число)
FrameWidth -> (длинное целое число)
ColorRange -> (строка)
Persons -> (список)
Массив людей, PersonMatch, в видео, чьи лица совпадают с лицами в коллекции Amazon Rekognition. Он также включает информацию о времени, когда лица людей совпадают в видео. Вы указываете входную коллекцию в начальном вызове к StartFaceSearch. Каждый элемент Persons включает время совпадения человека, детали совпадения лица (FaceMatches) для сопоставления лиц в коллекции и информацию о человеке (Person) для сопоставленного человека.
(структура)
Информация о человеке, чье лицо совпадает с лицом(ами) в коллекции Amazon Rekognition. Включает информацию о лицах в коллекции Amazon Rekognition (FaceMatch), информацию о человеке (PersonDetail) и отметку времени, когда человек был обнаружен в видео. Массив объектов PersonMatch возвращается методом GetFaceSearch.
Timestamp -> (long)
Person -> (структура)
Информация о сопоставленном человеке.
Index -> (long)
BoundingBox -> (структура)
Прямоугольник вокруг обнаруженного человека.
Width -> (float)
Height -> (float)
Left -> (float)
Top -> (float)
Face -> (структура)
Подробности лица для обнаруженного человека.
BoundingBox -> (структура)
Прямоугольник лица. Свойство по умолчанию.
Width -> (float)
Height -> (float)
Left -> (float)
Top -> (float)
AgeRange -> (структура)
Оценённый диапазон возраста лица в годах. Low – наименьший, High – наибольший.
Low -> (integer)
High -> (integer)
Smile -> (структура)
Указывает, улыбается ли лицо, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
Eyeglasses -> (структура)
Указывает, носит ли лицо очки, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
Sunglasses -> (структура)
Указывает, носит ли лицо солнцезащитные очки, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
Gender -> (структура)
Предсказанный пол обнаруженного лица.
Value -> (string)
Confidence -> (float)
Beard -> (структура)
Указывает, есть ли у лица борода, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
Mustache -> (структура)
Указывает, есть ли у лица усы, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
EyesOpen -> (структура)
Указывает, открыты ли глаза на лице, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
MouthOpen -> (структура)
Указывает, открыт ли рот на лице, и уровень уверенности в определении.
Value -> (boolean)
Confidence -> (float)
Emotions -> (список)
Эмоции, которые, по-видимому, выражаются на лице, и уровень уверенности в определении. API определяет только внешний вид лица человека. Это не определение внутреннего эмоционального состояния и не должно использоваться таким образом. Например, человек, изображающий грустное лицо, может не быть грустным эмоционально.
(структура)
Эмоции, которые, по-видимому, выражаются на лице, и уровень уверенности в определении. API определяет только внешний вид лица человека. Это не определение внутреннего эмоционального состояния и не должно использоваться таким образом. Например, человек, изображающий грустное лицо, может не быть грустным эмоционально.
Type -> (string)
Confidence -> (float)
Landmarks -> (список)
Указывает расположение ориентиров на лице. Свойство по умолчанию.
(структура)
Указывает расположение ориентира на лице.
Type -> (string)
X -> (float)
Y -> (float)
Pose -> (структура)
Указывает позу лица, определяемую по углу наклона, углу поворота и углу вращения. Свойство по умолчанию.
Roll -> (float)
Yaw -> (float)
Pitch -> (float)
Quality -> (структура)
Определяет яркость и четкость изображения. Свойство по умолчанию.
Brightness -> (float)
Sharpness -> (float)
Confidence -> (float)
FaceOccluded -> (структура)
FaceOccluded должно возвращать «true» с высоким баллом уверенности, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, телефонами, руками или другими предметами. FaceOccluded должно возвращать «false» с высоким баллом уверенности, если обнаружены распространённые случаи, не влияющие на проверку лица, такие как очки, слегка затемнённые солнцезащитные очки, пряди волос и другие.Value -> (boolean)
Confidence -> (float)
EyeDirection -> (структура)
Указывает направление взгляда глаз, определяемое углом наклона и углом поворота.
Yaw -> (float)
Pitch -> (float)
Confidence -> (float)
FaceMatches -> (список)
Информация о лицах во входной коллекции, которые соответствуют лицу человека в видео.
(структура)
Предоставляет метаданные о лице. Кроме того, предоставляет уверенность в соответствии этого лица с входным лицом.
Similarity -> (float)
Face -> (структура)
Описывает свойства лица, такие как прямоугольник, идентификатор лица, идентификатор изображения исходного изображения и внешним идентификатор изображения, которые вы назначили.
FaceId -> (string)
BoundingBox -> (структура)
Прямоугольник лица.
Width -> (float)
Height -> (float)
Left -> (float)
Top -> (float)
ImageId -> (string)
ExternalImageId -> (string)
Confidence -> (float)
IndexFacesModelVersion -> (string)
UserId -> (string)
JobId -> (string)
Video -> (структура)
Видеофайл, хранящийся в ведре Amazon S3. Amazon Rekognition начинает операции с видео, такие как StartLabelDetection, используя Video для указания видео для анализа. Поддерживаемые форматы файлов — .mp4, .mov и .avi.
S3Object -> (структура)
Имя ведра Amazon S3 и имя файла для видео.
Bucket -> (строка)
Name -> (строка)
Version -> (строка)
JobTag -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
