Face Detection Operations - Detect

Ссылка

Служба:: Azure AI Services

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

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

Важный

Корпорация Майкрософт отставила или ограничена возможностями распознавания лиц, которые можно использовать для вывода эмоциональных состояний и атрибутов личности, которые, если неправильно используются, могут подвергать людей стереотипиям, дискриминации или несправедливому отказу в обслуживании. Отставные возможности — это эмоции и пол. Ограниченные возможности : возраст, улыбка, волосы, волосы и макияж. Электронная почта API распознавания лиц Azure, если у вас есть ответственный вариант использования, который будет использовать любую из ограниченных возможностей. Дополнительные сведения об этом решении здесь.

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

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". Рекомендуется использовать detection_03, так как его точность улучшается на небольших лицах (64x64 пикселей) и поворачивается ориентация лиц.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Количество секунд для кэшируемого идентификатора лица. Поддерживаемый диапазон от 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 (binary)	Двоичный файл входного изображения.

Ответы

Имя	Тип	Описание
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". Рекомендуется использовать detection_03, так как его точность улучшается на небольших лицах (64x64 пикселей) и поворачивается ориентация лиц.
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

Object

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

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

AccessoryType

Перечисление

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

Значение	Описание
glasses	Очки.
headwear	Нос головы.
mask	Маска.

BlurLevel

Перечисление

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

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

BlurProperties

Object

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

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

DetectionModel

Перечисление

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

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

ExposureLevel

Перечисление

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

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

ExposureProperties

Object

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

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

FaceAttributes

Object

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

Имя	Тип	Описание
accessories	AccessoryItem[]	Свойства, описывающие любые аксессуары на данном лице.
age	number (float)	Возраст в годах.
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 (float) minimum: 0 maximum: 1	Интенсивность улыбки, число между [0,1].

FaceAttributeType

Перечисление

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

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

FaceDetectionResult

Object

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

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

FaceError

Object

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

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

FaceErrorResponse

Object

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

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

FaceLandmarks

Object

Коллекция 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

Object

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

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

FacialHair

Object

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

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

GlassesType

Перечисление

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

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

HairColor

Object

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

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

HairColorType

Перечисление

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

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

HairProperties

Object

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

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

HeadPose

Object

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

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

LandmarkCoordinate

Object

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

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

MaskProperties

Object

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

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

MaskType

Перечисление

Тип маски.

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

NoiseLevel

Перечисление

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

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

NoiseProperties

Object

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

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

OcclusionProperties

Object

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

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

QualityForRecognition

Перечисление

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

Значение	Описание
high	Высокое качество.
low	Низкое качество.
medium	Среднее качество.

RecognitionModel

Перечисление

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

Значение	Описание
recognition_01	Модель распознавания по умолчанию для "Обнаружение". Все эти лица, созданные до марта 2019 года, связаны с этой моделью распознавания.
recognition_02	Модель распознавания выпущена в марте 2019 года.
recognition_03	Модель распознавания выпущена в мае 2020 года.
recognition_04	Модель распознавания, выпущенная в феврале 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

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