Spec-Zone.ru › AWS CLI v2

[ aws . rekognition ]

detect-moderation-labels

Описание

Обнаруживает небезопасное содержимое на изображении в формате JPEG или PNG. Используйте DetectModerationLabels для модерации изображений в соответствии с вашими требованиями. Например, вы можете захотеть отфильтровать изображения, содержащие обнажённость, но не изображения, содержащие эротические элементы.

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

Сведения о метках модерации см. в руководстве разработчика Amazon Rekognition в разделе «Обнаружение небезопасного содержимого».

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

Вы можете указать адаптер для использования при получении прогнозов меток, предоставив ProjectVersionArn аргументу ProjectVersion.

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

Синтаксис

  detect-moderation-labels
[--image <value>]
[--min-confidence <value>]
[--human-loop-config <value>]
[--project-version <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 -> (блоб)

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

--min-confidence (число с плавающей точкой)

Устанавливает минимальный уровень уверенности в метках для возврата. Amazon Rekognition не возвращает метки с уровнем уверенности ниже указанного значения.

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

--human-loop-config (структура)

Настраивает конфигурацию для оценки человеком, включая FlowDefinition, в которую будет отправлено изображение.

HumanLoopName -> (строка)

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

FlowDefinitionArn -> (строка)

Идентификатор ресурса Amazon (ARN) определения потока. Вы можете создать определение потока, используя операцию Amazon Sagemaker CreateFlowDefinition.

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

Устанавливает атрибуты входных данных.

ContentClassifiers -> (список)

Устанавливает, содержит ли входное изображение персональные данные.

(строка)

Сокращенный синтаксис:

HumanLoopName=string,FlowDefinitionArn=string,DataAttributes={ContentClassifiers=[string,string]}

Синтаксис JSON:

{
  "HumanLoopName": "string",
  "FlowDefinitionArn": "string",
  "DataAttributes": {
    "ContentClassifiers": ["FreeOfPersonallyIdentifiableInformation"|"FreeOfAdultContent", ...]
  }
}

--project-version (строка)

Идентификатор пользовательского адаптера. Ожидается ProjectVersionArn в качестве значения. Используйте API CreateProject или CreateProjectVersion для создания пользовательского адаптера.

--image-bytes (блоб)

Содержимое изображения для загрузки. Для указания содержимого локального файла используйте префикс 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
  • текст
  • таблица
  • 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-moderation-labels команда обнаруживает небезопасное содержимое на указанном изображении, хранящемся в ведре Amazon S3.

aws rekognition detect-moderation-labels \
    --image "S3Object={Bucket=MyImageS3Bucket,Name=gun.jpg}"

Вывод:

{
    "ModerationModelVersion": "3.0",
    "ModerationLabels": [
        {
            "Confidence": 97.29618072509766,
            "ParentName": "Violence",
            "Name": "Weapon Violence"
        },
        {
            "Confidence": 97.29618072509766,
            "ParentName": "",
            "Name": "Violence"
        }
    ]
}

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

Вывод

ModerationLabels -> (список)

Массив обнаруженных меток модерации. Для видео операций, это включает время, в миллисекундах от начала видео, когда они были обнаружены.

(структура)

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

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

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

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

Name -> (строка)

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

ParentName -> (строка)

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

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

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

ModerationModelVersion -> (строка)

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

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

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

HumanLoopArn -> (строка)

Идентификатор ресурса Amazon (ARN) созданного HumanLoop.

HumanLoopActivationReasons -> (список)

Показывает, нужна ли и почему нужна проверка человеком.

(строка)

HumanLoopActivationConditionsEvaluationResults -> (строка)

Показывает результат оценки условий, включая те условия, которые активировали проверку человеком.

ProjectVersion -> (строка)

Идентификатор пользовательского адаптера, который использовался во время вывода. Если во время вывода адаптер был ИСТЕКШИМ, то параметр не будет возвращен, указывая, что использовалась базовая версия проекта обнаружения модерации.

ContentTypes -> (список)

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

(структура)

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

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

Уровень уверенности метки.

Name -> (строка)

Имя метки

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

Spec-Zone.ru

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