get-label-detection

Описание

Получает результаты распознавания меток для анализа видео Amazon Rekognition, запущенного с помощью StartLabelDetection.

Операция распознавания меток запускается вызовом StartLabelDetection, который возвращает идентификатор задачи (JobId). Когда операция распознавания меток завершается, Amazon Rekognition публикует статус завершения в тему Amazon Simple Notification Service, зарегистрированную в начальном вызове StartlabelDetection.

Чтобы получить результаты операции распознавания меток, сначала проверьте, что значение статуса, опубликованное в тему Amazon SNS, равно SUCCEEDED. В таком случае, вызовите GetLabelDetection и передайте идентификатор задачи (JobId) из начального вызова StartLabelDetection.

Вы можете выбрать, как агрегировать результаты, используя параметр AggregateBy. По умолчанию используется метод агрегации TIMESTAMPS. Также можно агрегировать по SEGMENTS, что агрегирует все экземпляры распознанных меток в данном сегменте.

Возвращаемый массив меток может включать следующие атрибуты:

• Имя - Имя распознанной метки.
• Уверенность - Уровень уверенности в метке, присвоенной распознанному объекту.
• Родители - Родительские метки для распознанной метки. GetLabelDetection возвращает иерархическую таксономию распознанных меток. Например, распознанная машина может получить метку car. Метка car имеет две родительские метки: Vehicle (родительская) и Transportation (прародительская). Ответ включает все предков метки, где каждый предок — это уникальная метка. В предыдущем примере Car, Vehicle и Transportation возвращаются как уникальные метки в ответе.
• Псевдонимы - Возможные псевдонимы для метки.
• Категории - Категории меток, к которым относится распознанная метка.
• BoundingBox — Ограничивающие рамки описываются для всех экземпляров распознанных общих меток объектов, возвращаемых в массиве объектов Instance. Объект Instance содержит объект BoundingBox, описывающий расположение метки на входном изображении. Он также включает уверенность в точности распознанной ограничивающей рамки.
• Временная метка - Время в миллисекундах от начала видео, когда была распознана метка. Для агрегирования по SEGMENTS, структуры StartTimestampMillis, EndTimestampMillis и DurationMillis определяют сегмент. Хотя структура «Временная метка» все еще возвращается с каждой меткой, ее значение устанавливается равным StartTimestampMillis.

Информация о временной метке и ограничивающей рамке возвращается для распознанных экземпляров только в случае агрегации по TIMESTAMPS. Если агрегировать по SEGMENTS, информация о распознанных экземплярах не возвращается.

Также возвращается версия модели меток, используемой для распознавания.

Используйте параметр MaxResults, чтобы ограничить количество возвращаемых меток. Если результатов больше, чем указано в MaxResults, значение NextToken в ответе операции содержит маркер пагинации для получения следующего набора результатов. Чтобы получить следующую страницу результатов, вызовите GetlabelDetection и заполните параметр запроса NextToken значением маркера, возвращенным из предыдущего вызова GetLabelDetection.

Если вы получаете результаты с использованием Amazon Simple Notification Service, обратите внимание, что вы получите уведомление «ERROR», если задача столкнется с проблемой.

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

Синопсис

  get-label-detection
--job-id <value>
[--max-results <value>]
[--next-token <value>]
[--sort-by <value>]
[--aggregate-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 (строка)

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

--next-token (строка)

--sort-by (строка)

--aggregate-by (строка)

--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
• таблица
• 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.

Примеры

Получение результатов операции распознавания объектов и сцен

Следующая команда get-label-detection отобразит результаты операции распознавания объектов и сцен, которую вы запустили ранее, вызвав start-label-detection.

aws rekognition get-label-detection  \
    --job-id 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Вывод:

{
    "Labels": [
        {
            "Timestamp": 0,
            "Label": {
                "Instances": [],
                "Confidence": 50.19071578979492,
                "Parents": [
                    {
                        "Name": "Person"
                    },
                    {
                        "Name": "Crowd"
                    }
                ],
                "Name": "Audience"
            }
        },
        {
            "Timestamp": 0,
            "Label": {
                "Instances": [],
                "Confidence": 55.74115753173828,
                "Parents": [
                    {
                        "Name": "Room"
                    },
                    {
                        "Name": "Indoors"
                    },
                    {
                        "Name": "School"
                    }
                ],
                "Name": "Classroom"
            }
        }
    ],
    "JobStatus": "SUCCEEDED",
    "LabelModelVersion": "2.0",
    "VideoMetadata": {
        "Format": "QuickTime / MOV",
        "FrameRate": 29.970617294311523,
        "Codec": "h264",
        "DurationMillis": 6806,
        "FrameHeight": 1080,
        "FrameWidth": 1920
    },
    "NextToken": "BMugzAi4L72IERzQdbpyMQuEFBsjlo5W0Yx3mfG+sR9mm98E1/CpObenspRfs/5FBQFs4X7G"
}

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

Вывод

JobStatus -> (строка)

StatusMessage -> (строка)

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

NextToken -> (строка)

Labels -> (список)

LabelModelVersion -> (строка)

JobId -> (строка)

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

JobTag -> (строка)

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