detect-custom-labels

Описание

Обнаруживает пользовательские метки на предоставленном изображении с помощью модели Amazon Rekognition Custom Labels.

Вы указываете версию модели для использования с помощью параметра ProjectVersionArn.

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

Для каждого объекта, обнаруженного моделью, API возвращает объект (CustomLabel) в массиве (CustomLabels). Каждый объект (CustomLabel) содержит имя метки (Name), уровень уверенности в том, что изображение содержит объект (Confidence), и информацию о местоположении объекта на изображении (Geometry), если она существует. Обратите внимание, что для операции DetectCustomLabelsLabels, значения Polygons не возвращаются в разделе Geometry ответа.

Для фильтрации возвращаемых меток укажите значение для MinConfidence. DetectCustomLabelsLabels возвращает только метки с уровнем уверенности выше указанного значения. Значение MinConfidence соответствует предполагаемым пороговым значениям, созданным во время обучения. Для получения дополнительной информации см. Предполагаемый порог в руководстве разработчика Amazon Rekognition Custom Labels. Метрики Amazon Rekognition Custom Labels выражают предполагаемый порог как число с плавающей точкой от 0 до 1. Диапазон MinConfidence нормализует пороговое значение до процентного значения (0-100). Ответы с уровнем уверенности от DetectCustomLabels также возвращаются в процентах. Вы можете использовать MinConfidence, чтобы изменить точность и полноту вашей модели. Для получения дополнительной информации см. Анализ изображения в руководстве разработчика Amazon Rekognition Custom Labels.

Если вы не укажете значение для MinConfidence, DetectCustomLabels возвращает метки, основанные на предполагаемом пороге каждой метки.

Это бессостоятельная операция API. То есть операция не сохраняет никакие данные.

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

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

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

Синтаксис

  detect-custom-labels
--project-version-arn <value>
[--image <value>]
[--max-results <value>]
[--min-confidence <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]

Параметры

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

--image (структура)

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

Bytes=blob,S3Object={Bucket=string,Name=string,Version=string}

JSON синтаксис:

{
  "Bytes": blob,
  "S3Object": {
    "Bucket": "string",
    "Name": "string",
    "Version": "string"
  }
}

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

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

--image-bytes (blob)

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON строки. JSON строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с использованием предоставленного JSON значения, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON каркас в стандартный вывод без отправки запроса API. Если предоставлено значение null или 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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого файла, которое соответствует двоичному блобу, 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.

Вывод

CustomLabels -> (список)