Face Detection Operations - Detect

Ссылка

Служба:: Azure AI Services

Версия API:: v1.2-preview.1

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

Важный

Корпорация Майкрософт отставила или ограничена возможностями распознавания лиц, которые можно использовать для вывода эмоциональных состояний и атрибутов личности, которые, если неправильно используются, могут подвергать людей стереотипиям, дискриминации или несправедливому отказу в обслуживании. Отставные возможности — это эмоции и пол. Ограниченные возможности : возраст, улыбка, волосы, волосы и макияж. Api распознавания лиц Azure azureface@microsoft.com, если у вас есть ответственный вариант использования, который будет использовать любую из ограниченных возможностей. Дополнительные сведения об этом решении https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Изображение не будет сохранено. На сервере будут храниться только извлеченные функции лиц. FaceId — это идентификатор функции лица и будет использоваться в разделе "Идентификация", "Проверка" и "Найти аналогично". Срок действия сохраненных функций лица истекает и удаляется в то время, указанное faceIdTimeToLive после первоначального вызова обнаружения.
- Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают headPose, очки, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
- Поддерживаются формат JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения составляет от 1 КБ до 6 МБ.
- Минимальный размер обнаруживаемого лица составляет 36x36 пикселей на изображении не более 1920x1080 пикселей. Изображения с измерениями выше 1920x1080 пикселей потребуется пропорционально больше минимального размера лица.
- Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника лица от большого до небольшого.
- Для оптимальных результатов при запросе "Определить", "Проверить" и "Найти аналогично" ("returnFaceId" имеет значение true), используйте лица, которые: фронтальные, четкие и с минимальным размером 200x200 пикселей (100 пикселей между глазами).
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - "detection_02": атрибуты лиц и ориентиры отключены, если выбрать эту модель обнаружения.
  - "detection_03": атрибуты лиц (маски, размытия и headPose) и ориентиры поддерживаются, если выбрать эту модель обнаружения.
- Предоставляются разные значения "recognitionModel". Если требуются следующие операции, такие как "Проверить", "Определить", "Найти аналогичный", укажите модель распознавания с параметром "recognitionModel". Значение по умолчанию для "recognitionModel" равно "recognition_01", если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные faceIds будут связаны с указанной моделью распознавания. Дополнительные сведения см. в https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

POST {endpoint}/face/{apiVersion}/detect

С использованием необязательных параметров:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия API
endpoint	path	True	string uri	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя ресурса}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Объект detectionModel, связанный с обнаруженными идентификаторами лиц. Поддерживаемые значения detectionModel включают "detection_01", "detection_02" и "detection_03". Значение по умолчанию — "detection_01".
faceIdTimeToLive	query		integer int32	Количество секунд для кэшируемого идентификатора лица. Поддерживаемый диапазон от 60 секунд до 86400 секунд. Значение по умолчанию — 86400 (24 часа).
recognitionModel	query		RecognitionModel	Объект "recognitionModel", связанный с обнаруженными идентификаторами лиц. Поддерживаемые значения "recognitionModel" включают "recognition_01", "recognition_02", "recognition_03" или "recognition_04". Значение по умолчанию — "recognition_01". "recognition_04" рекомендуется, так как его точность улучшается на лицах носить маски по сравнению с "recognition_03", и его общая точность улучшается по сравнению с "recognition_01" и "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Анализ и возврат одного или нескольких указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=headPose, очки. Анализ атрибутов распознавания лиц имеет дополнительные вычислительные и временные затраты.
returnFaceId	query		boolean	Возвращает идентификаторы лиц обнаруженных лиц или нет. Значение по умолчанию — true.
returnFaceLandmarks	query		boolean	Возврат ориентиров лица обнаруженных лиц или нет. Значение по умолчанию — false.
returnRecognitionModel	query		boolean	Возвращает значение "recognitionModel" или нет. Значение по умолчанию — false. Это применимо только в том случае, если returnFaceId = true.

Текст запроса

Media Types: "application/octet-stream"

Имя	Тип	Описание
imageContent	string	Двоичный файл входного изображения.

Ответы

Имя	Тип	Описание
200 OK	FaceDetectionResult[]	Успешный вызов возвращает массив записей лиц, ранжированных по размеру прямоугольника лица в порядке убывания. Пустой ответ указывает, что лица не обнаружены.
Other Status Codes	FaceErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

200 OK

FaceDetectionResult[]

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

Other Status Codes

FaceErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Секретный ключ для подписки Azure AI Face.

Тип: apiKey
В: header

AADToken

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://api.example.com/oauth2/authorize
URL-адрес токена: https://api.example.com/oauth2/token

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Detect with Image

Образец запроса

HTTP

POST {endpoint}/face/v1.2-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Пример ответа

Код состояния:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Определения

Имя	Описание
AccessoryItem	Элемент аксессуара и соответствующий уровень достоверности.
AccessoryType	Тип аксессуара.
BlurLevel	Указывает уровень размытости.
BlurProperties	Свойства, описывающие любое присутствие размытия в изображении.
DetectionModel	Объект detectionModel, связанный с обнаруженными идентификаторами лиц. Поддерживаемые значения detectionModel включают "detection_01", "detection_02" и "detection_03". Значение по умолчанию — "detection_01".
ExposureLevel	Указывает уровень воздействия.
ExposureProperties	Свойства, описывающие уровень экспозиции изображения.
FaceAttributes	Атрибуты лиц для обнаруженного лица.
FaceAttributeType	Анализ и возврат одного или нескольких указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=headPose, очки. Анализ атрибутов распознавания лиц имеет дополнительные вычислительные и временные затраты.
FaceDetectionResult	Ответ для обнаружения API.
FaceError	Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.
FaceLandmarks	Коллекция 27-точек лиц ориентиры, указывающие на важные позиции компонентов лица.
FaceRectangle	Прямоугольник, в котором можно найти лицо.
FacialHair	Свойства, описывающие атрибуты волос лица.
GlassesType	Очки типа лица.
HairColor	Массив цветов кандидатов и уровень достоверности в присутствии каждого из них.
HairColorType	Имя цвета волос.
HairProperties	Свойства, описывающие атрибуты волос.
HeadPose	3-D roll/yaw/pitch углов для направления лица.
LandmarkCoordinate	Координаты ориентира в изображении.
MaskProperties	Свойства, описывающие наличие маски на данном лице.
MaskType	Тип маски.
NoiseLevel	Указывает уровень шума.
NoiseProperties	Свойства, описывающие уровень шума изображения.
OcclusionProperties	Свойства, описывающие окклюзии на заданном лице.
QualityForRecognition	Указывает качество изображения для распознавания.
RecognitionModel	Модель распознавания лица.

AccessoryItem

Элемент аксессуара и соответствующий уровень достоверности.

Имя	Тип	Описание
confidence	number	Уровень достоверности типа аксессуара. Диапазон от [0,1].
type	AccessoryType	Тип аксессуара.

AccessoryType

Тип аксессуара.

Имя	Тип	Описание
glasses	string	Очки.
headwear	string	Нос головы.
mask	string	Маска.

BlurLevel

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

Имя	Тип	Описание
high	string	Высокий уровень размытия.
low	string	Низкий уровень размытия.
medium	string	Средний уровень размытия.

BlurProperties

Свойства, описывающие любое присутствие размытия в изображении.

Имя	Тип	Описание
blurLevel	BlurLevel	Значение перечисления, указывающее уровень размытости.
value	number	Число, указывающее уровень размытости от 0 до 1.

DetectionModel

Объект detectionModel, связанный с обнаруженными идентификаторами лиц. Поддерживаемые значения detectionModel включают "detection_01", "detection_02" и "detection_03". Значение по умолчанию — "detection_01".

Имя	Тип	Описание
detection_01	string	Модель обнаружения по умолчанию. Рекомендуется для обнаружения лиц вблизи переднего плана. В сценариях с исключительно большими углами (поза головы) лица, occluded лица или неправильной ориентацией изображения, лица в таких случаях могут быть не обнаружены.
detection_02	string	Модель обнаружения, выпущенная в мае 2019 года с улучшенной точностью, особенно на небольших, боковой и размытых лицах.
detection_03	string	Модель обнаружения, выпущенная в феврале 2021 года с улучшенной точностью, особенно на небольших лицах.

ExposureLevel

Указывает уровень воздействия.

Имя	Тип	Описание
goodExposure	string	Хороший уровень воздействия.
overExposure	string	Высокий уровень воздействия.
underExposure	string	Низкий уровень воздействия.

ExposureProperties

Свойства, описывающие уровень экспозиции изображения.

Имя	Тип	Описание
exposureLevel	ExposureLevel	Значение перечисления, указывающее уровень воздействия.
value	number	Число, указывающее уровень воздействия от 0 до 1. [0, 0,25) находится под воздействием. [0.25, 0,75) является хорошим воздействием. [0.75, 1] превышает воздействие.

FaceAttributes

Атрибуты лиц для обнаруженного лица.

Имя	Тип	Описание
accessories	AccessoryItem[]	Свойства, описывающие любые аксессуары на данном лице.
age	number	Возраст в годах.
blur	BlurProperties	Свойства, описывающие любое присутствие размытия в изображении.
exposure	ExposureProperties	Свойства, описывающие уровень экспозиции изображения.
facialHair	FacialHair	Свойства, описывающие атрибуты волос лица.
glasses	GlassesType	Очки введите, если любой из лиц.
hair	HairProperties	Свойства, описывающие атрибуты волос.
headPose	HeadPose	3-D roll/yaw/pitch углов для направления лица.
mask	MaskProperties	Свойства, описывающие наличие маски на данном лице.
noise	NoiseProperties	Свойства, описывающие уровень шума изображения.
occlusion	OcclusionProperties	Свойства, описывающие окклюзии на заданном лице.
qualityForRecognition	QualityForRecognition	Свойства, описывающие общее качество изображения относительно того, является ли изображение, используемое в обнаружении, достаточно качеством для попытки распознавания лиц.
smile	number	Интенсивность улыбки, число между [0,1].

FaceAttributeType

Анализ и возврат одного или нескольких указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=headPose, очки. Анализ атрибутов распознавания лиц имеет дополнительные вычислительные и временные затраты.

Имя	Тип	Описание
accessories	string	Аксессуары вокруг лица, в том числе "очки", "очки" и "маска". Пустой массив означает, что аксессуары не обнаружены. Обратите внимание, что это происходит после обнаружения лица. Большая маска не может привести к обнаружению лица.
age	string	Возраст в годах.
blur	string	Лицо размыто или нет. Уровень возвращает значение "Низкий", "Средний" или "Высокий". Значение возвращает число между [0,1], чем больше размытие.
exposure	string	Уровень воздействия лица. Уровень возвращает "Good Exposure", "Over Exposure" или "Under Exposure".
facialHair	string	Свойства, описывающие атрибуты волос лица.
glasses	string	Тип очков. К значениям относятся NoGlasses, ReadingGlasses, Sunglasses, SwimmingGoggles.
hair	string	Свойства, описывающие атрибуты волос.
headPose	string	3-D roll/yaw/pitch углов для направления лица.
mask	string	Независимо от того, носит ли каждое лицо маску. Тип маски возвращает "noMask", "faceMask", "otherMaskOrOcclusion" или "неопределенный". Значение возвращает логическое значение "носAndMouthCovered", указывающее, покрыты ли нос и рот.
noise	string	Уровень шума пикселей лиц. Уровень возвращает значение "Низкий", "Средний" и "Высокий". Значение возвращает число между [0,1], чем больше шумный
occlusion	string	Независимо от того, является ли каждая область лица окклудирована, включая лоб, глаза и рот.
qualityForRecognition	string	Общее качество изображения относительно того, является ли изображение, используемое в обнаружении, достаточно качеством для попытки распознавания лиц. Значение является неофициальным рейтингом низкого, среднего или высокого. Для сценариев идентификации рекомендуется использовать только высококачественные изображения для регистрации пользователей и качества с помощью "среднего" или выше. Атрибут доступен только при использовании моделей распознавания recognition_03 или recognition_04.
smile	string	Интенсивность улыбки, число между [0,1].

FaceDetectionResult

Ответ для обнаружения API.

Имя	Тип	Описание
faceAttributes	FaceAttributes	Атрибуты лица для обнаруженного лица.
faceId	string	Уникальный faceId обнаруженного лица, созданного API обнаружения и срок действия которого истекает через 24 часа после вызова обнаружения. Чтобы вернуть это, необходимо, чтобы параметр returnFaceId был true.
faceLandmarks	FaceLandmarks	Массив 27-точек лица ориентиры, указывающие на важные позиции компонентов лица. Чтобы вернуть это значение, параметр returnFaceLandmarks должен иметь значение true.
faceRectangle	FaceRectangle	Прямоугольная область для расположения лица на изображении.
recognitionModel	RecognitionModel	Идентификатор распознавания, связанный с этим faceId. Это возвращается только в том случае, если значение returnRecognitionModel явно задано как true.

FaceError

Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
message	string	Читаемое пользователем представление ошибки.

FaceErrorResponse

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

Имя	Тип	Описание
error	FaceError	Объект ошибки.

FaceLandmarks

Коллекция 27-точек лиц ориентиры, указывающие на важные позиции компонентов лица.

Имя	Тип	Описание
eyeLeftBottom	LandmarkCoordinate	Координаты левого глаза внизу.
eyeLeftInner	LandmarkCoordinate	Координаты левого глаза внутренней.
eyeLeftOuter	LandmarkCoordinate	Координаты левого глаза внешняя.
eyeLeftTop	LandmarkCoordinate	Координаты левого глаза сверху.
eyeRightBottom	LandmarkCoordinate	Координаты правого глаза внизу.
eyeRightInner	LandmarkCoordinate	Координаты правого глаза внутренней.
eyeRightOuter	LandmarkCoordinate	Координаты правого глаза.
eyeRightTop	LandmarkCoordinate	Координаты правого глаза сверху.
eyebrowLeftInner	LandmarkCoordinate	Координаты левой брови внутренней.
eyebrowLeftOuter	LandmarkCoordinate	Координаты левой брови внешней.
eyebrowRightInner	LandmarkCoordinate	Координаты правой брови внутренней.
eyebrowRightOuter	LandmarkCoordinate	Координаты правой брови внешней.
mouthLeft	LandmarkCoordinate	Координаты левого рта.
mouthRight	LandmarkCoordinate	Координаты правого рта.
noseLeftAlarOutTip	LandmarkCoordinate	Координаты носа левого алара из кончика.
noseLeftAlarTop	LandmarkCoordinate	Координаты носа слева от алара сверху.
noseRightAlarOutTip	LandmarkCoordinate	Координаты носа справа на кончике.
noseRightAlarTop	LandmarkCoordinate	Координаты носа справа от алара сверху.
noseRootLeft	LandmarkCoordinate	Координаты левого корня носа.
noseRootRight	LandmarkCoordinate	Координаты корня носа справа.
noseTip	LandmarkCoordinate	Координаты кончика носа.
pupilLeft	LandmarkCoordinate	Координаты левого зрачка глаза.
pupilRight	LandmarkCoordinate	Координаты правого зрачка.
underLipBottom	LandmarkCoordinate	Координаты нижней губы.
underLipTop	LandmarkCoordinate	Координаты нижней губы.
upperLipBottom	LandmarkCoordinate	Координаты верхней губы внизу.
upperLipTop	LandmarkCoordinate	Координаты верхней губы.

FaceRectangle

Прямоугольник, в котором можно найти лицо.

Имя	Тип	Описание
height	integer	Высота прямоугольника в пикселях.
left	integer	Расстояние от левого края, если изображение до левого края прямоугольника в пикселях.
top	integer	Расстояние от верхнего края, если изображение до верхнего края прямоугольника в пикселях.
width	integer	Ширина прямоугольника в пикселях.

FacialHair

Свойства, описывающие атрибуты волос лица.

Имя	Тип	Описание
beard	number	Число от 0 до 1, указывающее уровень достоверности, связанный со свойством.
moustache	number	Число от 0 до 1, указывающее уровень достоверности, связанный со свойством.
sideburns	number	Число от 0 до 1, указывающее уровень достоверности, связанный со свойством.

GlassesType

Очки типа лица.

Имя	Тип	Описание
noGlasses	string	Ни очки на лице.
readingGlasses	string	Обычные очки на лице.
sunglasses	string	Солнцезащитные очки на лице.
swimmingGoggles	string	Плавать очки на лице.

HairColor

Массив цветов кандидатов и уровень достоверности в присутствии каждого из них.

Имя	Тип	Описание
color	HairColorType	Имя цвета волос.
confidence	number	Уровень достоверности цвета. Диапазон от [0,1].

HairColorType

Имя цвета волос.

Имя	Тип	Описание
black	string	Чёрный.
blond	string	Блондин.
brown	string	Коричневый.
gray	string	Серый.
other	string	Другой.
red	string	Красный.
unknown	string	Неизвестный.
white	string	Белый.

HairProperties

Свойства, описывающие атрибуты волос.

Имя	Тип	Описание
bald	number	Число, описывающее уровень достоверности того, является ли человек лысым.
hairColor	HairColor[]	Массив цветов кандидатов и уровень достоверности в присутствии каждого из них.
invisible	boolean	Логическое значение, описывающее, отображается ли волосы на изображении.

HeadPose

3-D roll/yaw/pitch углов для направления лица.

Имя	Тип	Описание
pitch	number	Значение углов.
roll	number	Значение углов.
yaw	number	Значение углов.

LandmarkCoordinate

Координаты ориентира в изображении.

Имя	Тип	Описание
x	number	Горизонтальный компонент в пикселях.
y	number	Вертикальный компонент в пикселях.

MaskProperties

Свойства, описывающие наличие маски на данном лице.

Имя	Тип	Описание
noseAndMouthCovered	boolean	Логическое значение, указывающее, покрыты ли нос и рот.
type	MaskType	Тип маски.

MaskType

Тип маски.

Имя	Тип	Описание
faceMask	string	Маска.
noMask	string	Нет маски.
otherMaskOrOcclusion	string	Другие типы маски или окклюзии.
uncertain	string	Неопределённый.

NoiseLevel

Указывает уровень шума.

Имя	Тип	Описание
high	string	Высокий уровень шума.
low	string	Низкий уровень шума.
medium	string	Средний уровень шума.

NoiseProperties

Свойства, описывающие уровень шума изображения.

Имя	Тип	Описание
noiseLevel	NoiseLevel	Значение перечисления, указывающее уровень шума.
value	number	Число, указывающее уровень шума от 0 до 1. [0, 0,25) находится под воздействием. [0.25, 0,75) является хорошим воздействием. [0.75, 1] превышает воздействие. [0, 0.3) — низкий уровень шума. [0.3, 0.7) — средний уровень шума. [0,7, 1] — высокий уровень шума.

OcclusionProperties

Свойства, описывающие окклюзии на заданном лице.

Имя	Тип	Описание
eyeOccluded	boolean	Логическое значение, указывающее, являются ли глаза occluded.
foreheadOccluded	boolean	Логическое значение, указывающее, является ли головок окклудированным.
mouthOccluded	boolean	Логическое значение, указывающее, является ли рот occluded.

QualityForRecognition

Указывает качество изображения для распознавания.

Имя	Тип	Описание
high	string	Высокое качество.
low	string	Низкое качество.
medium	string	Среднее качество.

RecognitionModel

Модель распознавания лица.

Имя	Тип	Описание
recognition_01	string	Модель распознавания по умолчанию для "Обнаружение". Все эти лица, созданные до марта 2019 года, связаны с этой моделью распознавания.
recognition_02	string	Модель распознавания выпущена в марте 2019 года.
recognition_03	string	Модель распознавания выпущена в мае 2020 года.
recognition_04	string	Модель распознавания, выпущенная в феврале 2021 года. Рекомендуется использовать эту модель распознавания для повышения точности распознавания.

Поделиться через

Face Detection Operations - Detect

Параметры URI

Текст запроса

Ответы

Безопасность

Ocp-Apim-Subscription-Key

AADToken

Области

Примеры

Detect with Image

Образец запроса

Пример ответа

Определения

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel

Дополнительные ресурсы