Spec-Zone.ru › AWS CLI v2

[ aws . rekognition ]

получить-модерацию-контента

Описание

Получает результаты анализа контента, содержащего неприемлемые, нежелательные или оскорбительные элементы, для видео Amazon Rekognition, начатого с помощью StartContentModeration. Список меток модерации в Amazon Rekognition см. в разделе Использование API модерации изображений и видео.

Обнаружение неприемлемого или оскорбительного контента в хранящемся видео Amazon Rekognition — асинхронная операция. Вы запускаете анализ, вызывая StartContentModeration, которая возвращает идентификатор задания (JobId). После завершения анализа Amazon Rekognition Video публикует статус завершения в тему Amazon Simple Notification Service, зарегистрированную в первоначальном вызове к StartContentModeration. Для получения результатов анализа контента сначала проверьте, что значение статуса, опубликованное в теме Amazon SNS, равно SUCCEEDED. В противном случае вызовите GetContentModeration и передайте идентификатор задания (JobId) из первоначального вызова к StartContentModeration.

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

GetContentModeration возвращает обнаруженные метки модерации неприемлемого, нежелательного или оскорбительного контента и время их обнаружения в массиве ModerationLabels объектов ContentModerationDetection.

По умолчанию метки модерации возвращаются, отсортированные по времени в миллисекундах с начала видео. Вы также можете отсортировать их по метке модерации, указав NAME для параметра входных данных SortBy.

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

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

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

Синтаксис

  get-content-moderation
--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 (строка)

Идентификатор задания модерации контента, содержащего неприемлемые, нежелательные или оскорбительные элементы. Используйте JobId для идентификации задания в последующем вызове к GetContentModeration.

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

Максимальное количество результатов, возвращаемых за раз при пагинации. Максимальное значение, которое вы можете указать, равно 1000. Если вы укажете значение больше 1000, будет возвращено максимальное количество результатов — 1000. Значение по умолчанию равно 1000.

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

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

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

Сортировка элементов в массиве ModerationLabelDetections. Используйте TIMESTAMP для сортировки элементов массива по времени обнаружения меток. Используйте NAME для сортировки элементов по меткам в алфавитном порядке. Внутри каждой группы меток элементы массива сортируются по уверенности в обнаружении. По умолчанию сортировка выполняется по TIMESTAMP.

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

  • NAME
  • TIMESTAMP

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

Определяет, как агрегировать результаты запроса StartContentModeration. По умолчанию используется режим агрегации TIMESTAMPS. Режим SEGMENTS агрегирует метки модерации во времени.

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

  • TIMESTAMPS
  • SEGMENTS

--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.

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

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

aws rekognition get-content-moderation \
    --job-id 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Вывод:

{
    "NextToken": "dlhcKMHMzpCBGFukz6IO3JMcWiJAamCVhXHt3r6b4b5Tfbyw3q7o+Jeezt+ZpgfOnW9FCCgQ",
    "ModerationLabels": [
        {
            "Timestamp": 0,
            "ModerationLabel": {
                "Confidence": 97.39583587646484,
                "ParentName": "",
                "Name": "Violence"
            }
        },
        {
            "Timestamp": 0,
            "ModerationLabel": {
                "Confidence": 97.39583587646484,
                "ParentName": "Violence",
                "Name": "Weapon Violence"
            }
        }
    ],
    "JobStatus": "SUCCEEDED",
    "VideoMetadata": {
        "Format": "QuickTime / MOV",
        "FrameRate": 29.97515869140625,
        "Codec": "h264",
        "DurationMillis": 6039,
        "FrameHeight": 1920,
        "FrameWidth": 1080
    }
}

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

Результат

JobStatus -> (строка)

Текущий статус задачи анализа модерации контента.

StatusMessage -> (строка)

Если задача завершится неудачно, StatusMessage предоставляет описательное сообщение об ошибке.

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

Информация о видео, которое проанализировал Amazon Rekognition. Videometadata возвращается на каждой странице постраничных ответов от GetContentModeration.

Codec -> (строка)

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

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

Длительность видео в миллисекундах.

Format -> (строка)

Формат проанализированного видео. Возможные значения: MP4, MOV и AVI.

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

Количество кадров в секунду в видео.

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

Вертикальное разрешение видео в пикселях.

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

Горизонтальное разрешение видео в пикселях.

ColorRange -> (строка)

Описание диапазона значений яркости в видео, либо LIMITED (16 до 235), либо FULL (0 до 255).

ModerationLabels -> (список)

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

(структура)

Информация об обнаружении метки неподходящего, нежелательного или оскорбительного контента в сохранённом видео.

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

Время в миллисекундах с начала видео, когда была обнаружена метка модерации контента. Обратите внимание, что Timestamp не гарантирует точность до отдельных кадров, где появляется модерациируемый контент.

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

Метка модерации контента, обнаруженная в сохранённом видео.

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

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

Если вы не укажете параметр MinConfidence в вызове DetectModerationLabels, операция возвращает метки с уровнем уверенности не менее 50 процентов.

Name -> (строка)

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

ParentName -> (строка)

Имя родительской метки. Метки на верхнем уровне иерархии имеют родительскую метку "".

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

Уровень метки модерации в отношении её таксономии, от 1 до 3.

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

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

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

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

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

Продолжительность отрезка в миллисекундах, т.е. время, прошедшее от StartTimestampMillis до EndTimestampMillis.

ContentTypes -> (список)

Список прогнозируемых результатов для типа контента, содержащегося в изображении. Например, контент изображения может быть из анимации, спорта или видеоигры.

(структура)

Содержит информацию о доверии и имени обнаруженного типа контента.

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

Уровень доверия к метке.

Name -> (строка)

Имя метки

NextToken -> (строка)

Если ответ усечён, Amazon Rekognition Video возвращает этот маркер, который можно использовать в последующем запросе для получения следующего набора меток модерации контента.

ModerationModelVersion -> (строка)

Номер версии модели обнаружения модерации, которая использовалась для обнаружения неподходящего, нежелательного или оскорбительного контента.

JobId -> (строка)

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

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

Файл видео, хранящийся в ведре Amazon S3. Amazon Rekognition видео стартовые операции, такие как StartLabelDetection, используют Video для указания видео для анализа. Поддерживаемые форматы файлов: .mp4, .mov и .avi.

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

Имя ведра Amazon S3 и имя файла для видео.

Bucket -> (строка)

Имя ведра S3.

Name -> (строка)

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

Version -> (строка)

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

JobTag -> (строка)

Идентификатор задачи, указанный в вызове StartContentModeration и возвращаемый в уведомлении о завершении задачи, отправленном вашей теме Amazon Simple Notification Service.

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

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

SortBy -> (строка)

Метод сортировки, выбранный для запроса GetContentModeration.

AggregateBy -> (строка)

Метод агрегирования, выбранный для запроса GetContentModeration.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API