recognize-celebrities

Описание

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

RecognizeCelebrities возвращает 64 самых крупных лица на изображении. Список распознанных знаменитостей находится в массиве CelebrityFaces, а нераспознанные лица — в массиве UnrecognizedFaces. RecognizeCelebrities не возвращает знаменитостей, чьи лица не входят в число 64 самых крупных на изображении.

Для каждой распознанной знаменитости RecognizeCelebrities возвращает объект Celebrity. Объект Celebrity содержит имя знаменитости, идентификатор, ссылки на дополнительную информацию, уверенность в совпадении и объект ComparedFace, который вы можете использовать для определения местоположения лица знаменитости на изображении.

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

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

Пример см. в руководстве разработчика Amazon Rekognition в разделе Распознавание знаменитостей на изображении.

Для выполнения этой операции требуются разрешения на выполнение операции rekognition:RecognizeCelebrities.

См. также: Документация AWS API

Синтаксис

  recognize-celebrities
[--image <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.

Bytes -> (blob)

Блоб байтов изображения до 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"
  }
}

--image-bytes (blob)

Содержимое изображения для загрузки. Для указания содержимого локального файла используйте префикс 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 (логическое значение)

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

--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 для получения дополнительной информации.

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

Для распознавания знаменитостей на изображении

Следующая команда recognize-celebrities распознает знаменитостей на указанном изображении, хранящемся в ведре Amazon S3:

aws rekognition recognize-celebrities \
    --image "S3Object={Bucket=MyImageS3Bucket,Name=moviestars.jpg}"

Вывод:

{
    "UnrecognizedFaces": [
        {
            "BoundingBox": {
                "Width": 0.14416666328907013,
                "Top": 0.07777778059244156,
                "Left": 0.625,
                "Height": 0.2746031880378723
            },
            "Confidence": 99.9990234375,
            "Pose": {
                "Yaw": 10.80408763885498,
                "Roll": -12.761146545410156,
                "Pitch": 10.96889877319336
            },
            "Quality": {
                "Sharpness": 94.1185531616211,
                "Brightness": 79.18367004394531
            },
            "Landmarks": [
                {
                    "Y": 0.18220913410186768,
                    "X": 0.6702951788902283,
                    "Type": "eyeLeft"
                },
                {
                    "Y": 0.16337193548679352,
                    "X": 0.7188183665275574,
                    "Type": "eyeRight"
                },
                {
                    "Y": 0.20739148557186127,
                    "X": 0.7055801749229431,
                    "Type": "nose"
                },
                {
                    "Y": 0.2889308035373688,
                    "X": 0.687512218952179,
                    "Type": "mouthLeft"
                },
                {
                    "Y": 0.2706988751888275,
                    "X": 0.7250053286552429,
                    "Type": "mouthRight"
                }
            ]
        }
    ],
    "CelebrityFaces": [
        {
            "MatchConfidence": 100.0,
            "Face": {
                "BoundingBox": {
                    "Width": 0.14000000059604645,
                    "Top": 0.1190476194024086,
                    "Left": 0.82833331823349,
                    "Height": 0.2666666805744171
                },
                "Confidence": 99.99359130859375,
                "Pose": {
                    "Yaw": -10.509642601013184,
                    "Roll": -14.51749324798584,
                    "Pitch": 13.799399375915527
                },
                "Quality": {
                    "Sharpness": 78.74752044677734,
                    "Brightness": 42.201324462890625
                },
                "Landmarks": [
                    {
                        "Y": 0.2290833294391632,
                        "X": 0.8709492087364197,
                        "Type": "eyeLeft"
                    },
                    {
                        "Y": 0.20639978349208832,
                        "X": 0.9153988361358643,
                        "Type": "eyeRight"
                    },
                    {
                        "Y": 0.25417643785476685,
                        "X": 0.8907724022865295,
                        "Type": "nose"
                    },
                    {
                        "Y": 0.32729196548461914,
                        "X": 0.8876466155052185,
                        "Type": "mouthLeft"
                    },
                    {
                        "Y": 0.3115464746952057,
                        "X": 0.9238573312759399,
                        "Type": "mouthRight"
                    }
                ]
            },
            "Name": "Celeb A",
            "Urls": [
                "www.imdb.com/name/aaaaaaaaa"
            ],
            "Id": "1111111"
        },
        {
            "MatchConfidence": 97.0,
            "Face": {
                "BoundingBox": {
                    "Width": 0.13333334028720856,
                    "Top": 0.24920634925365448,
                    "Left": 0.4449999928474426,
                    "Height": 0.2539682686328888
                },
                "Confidence": 99.99979400634766,
                "Pose": {
                    "Yaw": 6.557040691375732,
                    "Roll": -7.316643714904785,
                    "Pitch": 9.272967338562012
                },
                "Quality": {
                    "Sharpness": 83.23492431640625,
                    "Brightness": 78.83267974853516
                },
                "Landmarks": [
                    {
                        "Y": 0.3625510632991791,
                        "X": 0.48898839950561523,
                        "Type": "eyeLeft"
                    },
                    {
                        "Y": 0.35366007685661316,
                        "X": 0.5313721299171448,
                        "Type": "eyeRight"
                    },
                    {
                        "Y": 0.3894785940647125,
                        "X": 0.5173314809799194,
                        "Type": "nose"
                    },
                    {
                        "Y": 0.44889405369758606,
                        "X": 0.5020005702972412,
                        "Type": "mouthLeft"
                    },
                    {
                        "Y": 0.4408611059188843,
                        "X": 0.5351271629333496,
                        "Type": "mouthRight"
                    }
                ]
            },
            "Name": "Celeb B",
            "Urls": [
                "www.imdb.com/name/bbbbbbbbb"
            ],
            "Id": "2222222"
        },
        {
            "MatchConfidence": 100.0,
            "Face": {
                "BoundingBox": {
                    "Width": 0.12416666746139526,
                    "Top": 0.2968254089355469,
                    "Left": 0.2150000035762787,
                    "Height": 0.23650793731212616
                },
                "Confidence": 99.99958801269531,
                "Pose": {
                    "Yaw": 7.801797866821289,
                    "Roll": -8.326810836791992,
                    "Pitch": 7.844768047332764
                },
                "Quality": {
                    "Sharpness": 86.93206024169922,
                    "Brightness": 79.81291198730469
                },
                "Landmarks": [
                    {
                        "Y": 0.4027804136276245,
                        "X": 0.2575301229953766,
                        "Type": "eyeLeft"
                    },
                    {
                        "Y": 0.3934555947780609,
                        "X": 0.2956969439983368,
                        "Type": "eyeRight"
                    },
                    {
                        "Y": 0.4309830069541931,
                        "X": 0.2837020754814148,
                        "Type": "nose"
                    },
                    {
                        "Y": 0.48186683654785156,
                        "X": 0.26812544465065,
                        "Type": "mouthLeft"
                    },
                    {
                        "Y": 0.47338807582855225,
                        "X": 0.29905644059181213,
                        "Type": "mouthRight"
                    }
                ]
            },
            "Name": "Celeb C",
            "Urls": [
                "www.imdb.com/name/ccccccccc"
            ],
            "Id": "3333333"
        },
        {
            "MatchConfidence": 97.0,
            "Face": {
                "BoundingBox": {
                    "Width": 0.11916666477918625,
                    "Top": 0.3698412775993347,
                    "Left": 0.008333333767950535,
                    "Height": 0.22698412835597992
                },
                "Confidence": 99.99999237060547,
                "Pose": {
                    "Yaw": 16.38478660583496,
                    "Roll": -1.0260354280471802,
                    "Pitch": 5.975185394287109
                },
                "Quality": {
                    "Sharpness": 83.23492431640625,
                    "Brightness": 61.408443450927734
                },
                "Landmarks": [
                    {
                        "Y": 0.4632347822189331,
                        "X": 0.049406956881284714,
                        "Type": "eyeLeft"
                    },
                    {
                        "Y": 0.46388113498687744,
                        "X": 0.08722897619009018,
                        "Type": "eyeRight"
                    },
                    {
                        "Y": 0.5020678639411926,
                        "X": 0.0758260041475296,
                        "Type": "nose"
                    },
                    {
                        "Y": 0.544157862663269,
                        "X": 0.054029736667871475,
                        "Type": "mouthLeft"
                    },
                    {
                        "Y": 0.5463630557060242,
                        "X": 0.08464983850717545,
                        "Type": "mouthRight"
                    }
                ]
            },
            "Name": "Celeb D",
            "Urls": [
                "www.imdb.com/name/ddddddddd"
            ],
            "Id": "4444444"
        }
    ]
}

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

Вывод

CelebrityFaces -> (список)

Подробная информация о каждой знаменитости, обнаруженной на изображении. Amazon Rekognition может определить не более 64 знаменитостей на изображении. Каждый объект знаменитости включает следующие атрибуты: Face , Confidence , Emotions , Landmarks , Pose , Quality , Smile , Id , KnownGender , MatchConfidence , Name , Urls .

(структура)

Предоставляет информацию о знаменитости, распознанной операцией RecognizeCelebrities.

Urls -> (список)

Массив URL-адресов, указывающих на дополнительную информацию о знаменитости. Если дополнительной информации нет, этот список пустой.

(строка)

Name -> (строка)

Имя знаменитости.

Id -> (строка)

Уникальный идентификатор знаменитости.

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

Предоставляет информацию о лице знаменитости, например, о его расположении на изображении.

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

Область, содержащая лицо.

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

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

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

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

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

Координата слева области, как отношение к общей ширине изображения.

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

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

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 (включительно). Более высокое значение указывает на более резкое изображение лица.

Emotions -> (список)

Эмоции, которые, по-видимому, выражены на лице, и уровень уверенности в определении. Допустимые значения включают «Счастье», «Грусть», «Злость», «Смятение», «Отвращение», «Удивление», «Спокойствие», «Неизвестно» и «Страх».

(структура)

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

Type -> (строка)

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

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

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

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

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

Value -> (булево)

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

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

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

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

Уверенность в том, что распознанное лицо — это знаменитость (в процентах).

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

Известный пол знаменитости, соответствующий предоставленному идентификатору. Известный пол может быть Мужской, Женский, Небинарный или Неопределённый.

Type -> (строка)

Строковое значение KnownGender о знаменитости.

UnrecognizedFaces -> (список)

Подробная информация о каждом нераспознанном лице на изображении.

(структура)

Предоставляет метаданные о лице для лиц на целевом изображении, проанализированных CompareFaces и RecognizeCelebrities .

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

Область, содержащая лицо.

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

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

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

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

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

Координата слева области, как отношение к общей ширине изображения.

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

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

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

Уровень уверенности в том, что в области находится лицо.

Landmarks -> (список)

Массив точек лица.

(структура)

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

Type -> (строка)

Тип точки.

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

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

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

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

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

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

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

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

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

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

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

Определяет яркость и резкость изображения лица.

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

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

Emotions -> (список)

(структура)

Type -> (строка)

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

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

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

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

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

Value -> (булево)

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

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

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

OrientationCorrection -> (строка)

Примечание

Поддержка оценки ориентации изображения с помощью поля OrientationCorrection прекращена с августа 2021 года. Любые возвращаемые значения для этого поля в ответе API всегда будут NULL.

Ориентация входного изображения (против часовой стрелки). Если ваше приложение отображает изображение, вы можете использовать это значение для коррекции ориентации. Координаты области, содержащей лицо, возвращаемые в CelebrityFaces и UnrecognizedFaces, представляют расположение лица до коррекции ориентации изображения.

Примечание

Если входное изображение в формате .jpeg, оно может содержать метаданные обмена изображениями (Exif), которые включают ориентацию изображения. В этом случае, если метаданные Exif входного изображения заполняют поле ориентации, значение OrientationCorrection равно null. Координаты области, содержащей лицо, в CelebrityFaces и UnrecognizedFaces, представляют расположение лица после коррекции ориентации изображения с помощью метаданных Exif. Изображения в формате .png не содержат метаданных Exif.