Face Detection Operations - Detect

Ссылка

Служба:: Azure AI Services

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

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

Важно!

Чтобы устранить потенциальное злоупотребление, которое может привести к стереотипам, дискриминации или несправедливого отказа в обслуживании, мы удаляем атрибуты API распознавания лиц, которые предсказывают эмоции, пол, возраст, улыбку, волосы на лице, волосы и макияж. См. дополнительные сведения об этом решении https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Образ не будет сохранен. На сервере будут храниться только извлеченные функции распознавания лиц. FaceId — это идентификатор функции распознавания лиц, который будет использоваться в параметрах "Идентификация", "Проверка" и "Поиск похожих". Срок действия сохраненных функций распознавания лиц истечет и будет удален в момент, указанный faceIdTimeToLive после первоначального вызова обнаружения.
- Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают headPose, очки, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника от больших к маленьким.
- Для получения оптимальных результатов при выполнении запросов "Identify", "Verify" и "Find Similar" ("returnFaceId" имеет значение true), используйте лица: фронтальные, четкие и с минимальным размером 200 x 200 пикселей (100 пикселей между глазами).
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': атрибуты и ориентиры лиц отключены при выборе этой модели обнаружения.
  - 'detection_03': атрибуты лиц (маска, размытие и headPose) и ориентиры поддерживаются при выборе этой модели обнаружения.
- Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как "Verify", "Identify", "Find Similar", укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные идентификаторы faceId будут связаны с указанной моделью распознавания. Дополнительные сведения см. в разделе 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, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01".
faceIdTimeToLive	query		integer int32	Количество секунд для кэширования идентификатора лица. Поддерживаемый диапазон от 60 до 86400 секунд. Значение по умолчанию — 86400 (24 часа).
recognitionModel	query		RecognitionModel	"recognitionModel", связанный с обнаруженными faceId. Поддерживаемые значения "recognitionModel" включают "recognition_01", "recognition_02", "recognition_03" или "recognition_04". Значение по умолчанию — "recognition_01". "recognition_04" рекомендуется, так как его точность улучшена на лицах носить маски по сравнению с "recognition_03", а его общая точность улучшена по сравнению с "recognition_01" и "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Проанализируйте и верните один или несколько указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=headPose,glasses. Анализ атрибутов лиц имеет дополнительные затраты на вычисления и время.
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.1-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, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01".
ExposureLevel	Указывает уровень экспозиции.
ExposureProperties	Свойства, описывающие уровень экспозиции изображения.
FaceAttributes	Атрибуты распознавания лиц для обнаруженного лица.
FaceAttributeType	Проанализируйте и верните один или несколько указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=headPose,glasses. Анализ атрибутов лиц имеет дополнительные затраты на вычисления и время.
FaceDetectionResult	Ответ для API обнаружения.
FaceError	Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.
FaceLandmarks	Коллекция 27-точечной ориентиров лица, указывающих на важные положения компонентов лица.
FaceRectangle	Прямоугольник, в котором можно найти лицо.
FacialHair	Свойства, описывающие атрибуты волос на лице.
GlassesType	Очки типа лица.
HairColor	Массив цветов-кандидатов и уровень достоверности в присутствии каждого из них.
HairColorType	Название цвета волос.
HairProperties	Свойства, описывающие атрибуты волос.
HeadPose	Трехмерные углы рулона, рыска и шаг для направления лица.
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, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01".

Имя	Тип	Описание
detection_01	string	Модель обнаружения по умолчанию. Рекомендуется для обнаружения лиц, близких к лобовой области. В сценариях с исключительно большими углами (положением головы) лиц, заключаемых лиц или неправильной ориентации изображения лица в таких случаях могут не обнаруживаться.
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	Трехмерные углы поворота, поворота и шага для направления лица.
mask	MaskProperties	Свойства, описывающие наличие маски на данном лице.
noise	NoiseProperties	Свойства, описывающие уровень шума изображения.
occlusion	OcclusionProperties	Свойства, описывающие окклюзии на данном лице.
qualityForRecognition	QualityForRecognition	Свойства, описывающие общее качество изображения относительно того, является ли изображение, используемое при обнаружении, достаточным качеством для попытки распознавания лиц.
smile	number	Интенсивность улыбки, число между [0,1].

FaceAttributeType

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

Имя	Тип	Описание
accessories	string	Аксессуары вокруг лица, в том числе "головные уборы", "очки" и "маска". Пустой массив означает, что аксессуары не обнаружены. Обратите внимание, что это происходит после обнаружения лица. Большая маска может привести к тому, что лицо не будет обнаружено.
age	string	Возраст в годах.
blur	string	Лицо размыто или нет. Функция Level возвращает значение "Low", "Medium" или "High". Значение возвращает число между [0,1], чем больше, тем размытее.
exposure	string	Уровень экспозиции лица. Level возвращает "GoodExposure", "Over Exposure" или "Under Exposure".
facialHair	string	Свойства, описывающие атрибуты волос на лице.
glasses	string	Тип очков. Значения: NoGlasses, ReadingGlasses, Sunglasses, SwimmingGoggles.
hair	string	Свойства, описывающие атрибуты волос.
headPose	string	Трехмерные углы поворота, поворота и шага для направления лица.
mask	string	Одета ли каждое лицо в маску. Тип маски возвращает "noMask", "faceMask", "otherMaskOrOcclusion" или "неопределенный". Значение возвращает логическое значение "noseAndMouthCovered", указывающее, покрыты ли нос и рот.
noise	string	Уровень шума пикселей лиц. Level возвращает "Низкий", "Средний" и "Высокий". Значение возвращает число между [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-точечных ориентиров, указывающий на важные позиции компонентов лица. Для возврата этого параметра требуется значение true для параметра returnFaceLandmarks.
faceRectangle	FaceRectangle	Прямоугольная область для расположения лица на изображении.
recognitionModel	RecognitionModel	"recognitionModel", связанный с этим faceId. Возвращается только в том случае, если для returnRecognitionModel явно задано значение true.

FaceError

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

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

FaceErrorResponse

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

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

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

Трехмерные углы рулона, рыска и шаг для направления лица.

Имя	Тип	Описание
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	Логическое значение, указывающее, заключаются ли глаза.
foreheadOccluded	boolean	Логическое значение, указывающее, включен ли лоб.
mouthOccluded	boolean	Логическое значение, указывающее, включен ли рот.

QualityForRecognition

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

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

RecognitionModel

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

Имя	Тип	Описание
recognition_01	string	Модель распознавания по умолчанию для "Detect". Все эти faceId, созданные до марта 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

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