[ aws . rekognition ]
detect-faces
Описание
Обнаруживает лица на изображении, переданном в качестве входных данных.
DetectFaces обнаруживает 100 крупнейших лиц на изображении. Для каждого обнаруженного лица операция возвращает подробности о лице. Эти данные включают прямоугольник, определяющий лицо, значение уверенности (что прямоугольник содержит лицо), и набор атрибутов, таких как точки лица (например, координаты глаз и рта), поза, наличие закрытия лица и так далее.Алгоритм распознавания лиц наиболее эффективен для фронтальных лиц. Для лиц, расположенных под не фронтальным углом или затененных, алгоритм может не обнаружить лица или обнаружить их с меньшей уверенностью.
Вы передаете входное изображение в виде закодированных байтов изображения в формате base64 или как ссылку на изображение в ведре Amazon S3. Если вы используете AWS CLI для вызова операций Amazon Rekognition, передача байтов изображения в формате base64 не поддерживается. Изображение должно быть в формате PNG или JPEG.
Примечание
Эта операция является бессостоятельной. То есть операция не сохраняет никаких данных.Для этой операции требуются разрешения на выполнение действия rekognition:DetectFaces.
См. также: Документацию API AWS
Синтаксис
detect-faces
[--image <value>]
[--attributes <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]
Параметры
--image (структура)
Входное изображение в виде закодированных в base64 байтов или объекта S3. Если вы используете AWS CLI для вызова операций Amazon Rekognition, передача закодированных в base64 байтов изображения не поддерживается.
Если вы используете AWS SDK для вызова операций Amazon Rekognition, возможно, вам не нужно кодировать в base64 байты изображения, переданные с помощью поля Bytes. Дополнительную информацию см. в разделе Изображения в руководстве разработчика Amazon Rekognition.
Для указания локального файла используйте --image-bytes вместо.
Байты -> (blob)
DetectCustomLabels, составляет 4 МБ.S3Object -> (структура)
Идентифицирует объект S3 как источник изображения.
Bucket -> (строка)
Name -> (строка)
Version -> (строка)
Сокращенный синтаксис:
Bytes=blob,S3Object={Bucket=string,Name=string,Version=string}
Синтаксис JSON:
{
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
--attributes (список)
Массив атрибутов лица, которые вы хотите получить. Подмножество атрибутов лица - DEFAULT , BoundingBox , Confidence , Pose , и Quality - всегда будут возвращены. Вы можете запросить определенные атрибуты лица (в дополнение к стандартному списку), используя ["DEFAULT", "FACE_OCCLUDED" ] или просто ["FACE_OCCLUDED" ]. Вы можете запросить все атрибуты лица, используя ["ALL"] . Запрос дополнительных атрибутов может увеличить время отклика.
Если вы укажете оба, ["ALL", "DEFAULT"], служба использует логический оператор «И» для определения возвращаемых атрибутов (в этом случае все атрибуты).
Обратите внимание, что, хотя атрибуты FaceOccluded и EyeDirection поддерживаются при использовании DetectFaces, они не поддерживаются при анализе видео с StartFaceDetection и GetFaceDetection.
(строка)
Синтаксис:
"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
--image-bytes (blob)
--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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из вашего файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включено
- выключено
- авто
--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.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическую запрос параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
За исключением случаев, когда указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.
Для обнаружения лиц на изображении
Следующая команда detect-faces обнаруживает лица на указанном изображении, хранящемся в ведре Amazon S3.
aws rekognition detect-faces \
--image '{"S3Object":{"Bucket":"MyImageS3Bucket","Name":"MyFriend.jpg"}}' \
--attributes "ALL"
Вывод:
{
"FaceDetails": [
{
"Confidence": 100.0,
"Eyeglasses": {
"Confidence": 98.91107940673828,
"Value": false
},
"Sunglasses": {
"Confidence": 99.7966537475586,
"Value": false
},
"Gender": {
"Confidence": 99.56611633300781,
"Value": "Male"
},
"Landmarks": [
{
"Y": 0.26721030473709106,
"X": 0.6204193830490112,
"Type": "eyeLeft"
},
{
"Y": 0.26831310987472534,
"X": 0.6776827573776245,
"Type": "eyeRight"
},
{
"Y": 0.3514654338359833,
"X": 0.6241428852081299,
"Type": "mouthLeft"
},
{
"Y": 0.35258132219314575,
"X": 0.6713621020317078,
"Type": "mouthRight"
},
{
"Y": 0.3140771687030792,
"X": 0.6428444981575012,
"Type": "nose"
},
{
"Y": 0.24662546813488007,
"X": 0.6001564860343933,
"Type": "leftEyeBrowLeft"
},
{
"Y": 0.24326619505882263,
"X": 0.6303644776344299,
"Type": "leftEyeBrowRight"
},
{
"Y": 0.23818562924861908,
"X": 0.6146903038024902,
"Type": "leftEyeBrowUp"
},
{
"Y": 0.24373626708984375,
"X": 0.6640064716339111,
"Type": "rightEyeBrowLeft"
},
{
"Y": 0.24877218902111053,
"X": 0.7025929093360901,
"Type": "rightEyeBrowRight"
},
{
"Y": 0.23938551545143127,
"X": 0.6823262572288513,
"Type": "rightEyeBrowUp"
},
{
"Y": 0.265746533870697,
"X": 0.6112898588180542,
"Type": "leftEyeLeft"
},
{
"Y": 0.2676128149032593,
"X": 0.6317071914672852,
"Type": "leftEyeRight"
},
{
"Y": 0.262735515832901,
"X": 0.6201658248901367,
"Type": "leftEyeUp"
},
{
"Y": 0.27025148272514343,
"X": 0.6206279993057251,
"Type": "leftEyeDown"
},
{
"Y": 0.268223375082016,
"X": 0.6658390760421753,
"Type": "rightEyeLeft"
},
{
"Y": 0.2672517001628876,
"X": 0.687832236289978,
"Type": "rightEyeRight"
},
{
"Y": 0.26383838057518005,
"X": 0.6769183874130249,
"Type": "rightEyeUp"
},
{
"Y": 0.27138751745224,
"X": 0.676596462726593,
"Type": "rightEyeDown"
},
{
"Y": 0.32283174991607666,
"X": 0.6350004076957703,
"Type": "noseLeft"
},
{
"Y": 0.3219289481639862,
"X": 0.6567046642303467,
"Type": "noseRight"
},
{
"Y": 0.3420318365097046,
"X": 0.6450609564781189,
"Type": "mouthUp"
},
{
"Y": 0.3664324879646301,
"X": 0.6455618143081665,
"Type": "mouthDown"
},
{
"Y": 0.26721030473709106,
"X": 0.6204193830490112,
"Type": "leftPupil"
},
{
"Y": 0.26831310987472534,
"X": 0.6776827573776245,
"Type": "rightPupil"
},
{
"Y": 0.26343393325805664,
"X": 0.5946047306060791,
"Type": "upperJawlineLeft"
},
{
"Y": 0.3543180525302887,
"X": 0.6044883728027344,
"Type": "midJawlineLeft"
},
{
"Y": 0.4084877669811249,
"X": 0.6477024555206299,
"Type": "chinBottom"
},
{
"Y": 0.3562754988670349,
"X": 0.707981526851654,
"Type": "midJawlineRight"
},
{
"Y": 0.26580461859703064,
"X": 0.7234612107276917,
"Type": "upperJawlineRight"
}
],
"Pose": {
"Yaw": -3.7351467609405518,
"Roll": -0.10309021919965744,
"Pitch": 0.8637830018997192
},
"Emotions": [
{
"Confidence": 8.74203109741211,
"Type": "SURPRISED"
},
{
"Confidence": 2.501944065093994,
"Type": "ANGRY"
},
{
"Confidence": 0.7378743290901184,
"Type": "DISGUSTED"
},
{
"Confidence": 3.5296201705932617,
"Type": "HAPPY"
},
{
"Confidence": 1.7162904739379883,
"Type": "SAD"
},
{
"Confidence": 9.518536567687988,
"Type": "CONFUSED"
},
{
"Confidence": 0.45474427938461304,
"Type": "FEAR"
},
{
"Confidence": 72.79895782470703,
"Type": "CALM"
}
],
"AgeRange": {
"High": 48,
"Low": 32
},
"EyesOpen": {
"Confidence": 98.93987274169922,
"Value": true
},
"BoundingBox": {
"Width": 0.12368916720151901,
"Top": 0.16007372736930847,
"Left": 0.5901257991790771,
"Height": 0.25140416622161865
},
"Smile": {
"Confidence": 93.4493179321289,
"Value": false
},
"MouthOpen": {
"Confidence": 90.53053283691406,
"Value": false
},
"Quality": {
"Sharpness": 95.51618957519531,
"Brightness": 65.29893493652344
},
"Mustache": {
"Confidence": 89.85221099853516,
"Value": false
},
"Beard": {
"Confidence": 86.1991195678711,
"Value": true
}
}
]
}
Для получения дополнительной информации см. раздел Обнаружение лиц на изображении в руководстве разработчика Amazon Rekognition.
Вывод
FaceDetails -> (список)
Подробная информация о каждом найденном лице на изображении.
(структура)
Структура, содержащая атрибуты лица, обнаруженного алгоритмом.
Объект FaceDetail содержит либо стандартные атрибуты лица, либо все атрибуты лица. Стандартные атрибуты включают BoundingBox , Confidence , Landmarks , Pose и Quality .
FaceDetail со всеми атрибутами. Чтобы указать, какие атрибуты возвращать, используйте параметр входных данных FaceAttributes для StartFaceDetection . Следующие операции Amazon Rekognition Video возвращают только стандартные атрибуты. Соответствующие операции Start не имеют параметра входных данных FaceAttributes:- GetCelebrityRecognition
- GetPersonTracking
- GetFaceSearch
Операции Amazon Rekognition Image DetectFaces и IndexFaces могут возвращать все атрибуты лица. Чтобы указать, какие атрибуты возвращать, используйте параметр входных данных Attributes для DetectFaces . Для IndexFaces используйте параметр входных данных DetectAttributes .
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 определяет только внешний вид лица человека. Это не определение внутреннего эмоционального состояния человека и не должно использоваться таким образом. Например, человек, делающий вид, что у него грустное лицо, может не быть грустным эмоционально.
(структура)
Эмоции, которые, по-видимому, выражены на лице, и уровень уверенности в определении. API определяет только внешний вид лица человека. Это не определение внутреннего эмоционального состояния человека и не должно использоваться таким образом. Например, человек, делающий вид, что у него грустное лицо, может не быть грустным эмоционально.
Type -> (строка)
Confidence -> (вещественное число)
Landmarks -> (список)
Указывает расположение ориентиров на лице. Стандартный атрибут.
(структура)
Указывает расположение ориентира на лице.
Type -> (строка)
X -> (вещественное число)
Y -> (вещественное число)
Pose -> (структура)
Указывает позу лица, определённую по углу наклона, углу вращения и углу поворота. Стандартный атрибут.
Roll -> (вещественное число)
Yaw -> (вещественное число)
Pitch -> (вещественное число)
Quality -> (структура)
Определяет яркость и резкость изображения. Стандартный атрибут.
Brightness -> (вещественное число)
Sharpness -> (вещественное число)
Confidence -> (вещественное число)
FaceOccluded -> (структура)
FaceOccluded должно возвращать «true» с высоким значением уверенности, если глаза, нос и рот обнаруженного лица частично видны или закрыты масками, тёмными солнцезащитными очками, мобильными телефонами, руками или другими предметами. FaceOccluded должно возвращать «false» с высоким значением уверенности, если обнаружены обычные ситуации, которые не влияют на проверку лица, такие как очки, слегка затемнённые солнцезащитные очки, пряди волос и другие.Value -> (булево значение)
Confidence -> (вещественное число)
EyeDirection -> (структура)
Указывает направление взгляда глаз, определённое по углу наклона и углу поворота.
Yaw -> (вещественное число)
Pitch -> (вещественное число)
Confidence -> (вещественное число)
OrientationCorrection -> (строка)
Значение OrientationCorrection всегда равно null.
Если входное изображение имеет формат .jpeg, оно может содержать метаданные EXIF (Exchangeable Image File Format), включающие ориентацию изображения. Amazon Rekognition использует эту информацию об ориентации для коррекции изображения. Координаты прямоугольника, окружающего объект, переводятся для представления местоположения объекта после использования информации об ориентации в метаданных EXIF для коррекции ориентации изображения. Изображения в формате .png не содержат метаданных EXIF.
Amazon Rekognition не выполняет коррекцию изображения для изображений в формате .png и .jpeg-изображений без информации об ориентации в метаданных EXIF изображения. Координаты прямоугольника, окружающего объект, не переводятся и представляют местоположение объекта до поворота изображения.
© Copyright 2025, Amazon Web Services. Created using Sphinx.
