Face Detection Operations - Detect

참조

Service:: Azure AI Services

API Version:: v1.1-preview.1

이미지에서 사람의 얼굴을 검색하고, 얼굴 사각형을 반환하고, 선택적으로 faceId, 랜드마크 및 특성을 함께 반환합니다.

중요

사람들이 스테레오티핑, 차별 또는 불공정한 서비스 거부의 대상이 될 수 있는 잠재적 오용을 완화하기 위해 감정, 성별, 나이, 미소, 얼굴 털, 머리카락 및 메이크업을 예측하는 Face API 특성을 사용 중지합니다. 이 결정에 https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/대해 자세히 알아보세요.

- 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 서버에 저장됩니다. faceId는 얼굴 기능의 식별자이며 "식별", "확인" 및 "유사 항목 찾기"에 사용됩니다. 저장된 얼굴 기능은 만료되며 원래 검색 호출 후 faceIdTimeToLive에 지정된 시간에 삭제됩니다.
- 선택적 매개 변수에는 faceId, 랜드마크 및 특성이 포함됩니다. 특성으로는 headPose, 안경, 폐색, 액세서리, 흐림, 노출, 노이즈, 마스크 및 품질ForRecognition이 포함됩니다. 특정 특성에 대해 반환된 결과 중 일부는 매우 정확하지 않을 수 있습니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 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': 이 검색 모델을 선택하면 얼굴 특성(마스크, 흐림 및 헤드포즈) 및 랜드마크가 지원됩니다.
- 다른 'recognitionModel' 값이 제공됩니다. "확인", "식별", "유사 항목 찾기"와 같은 후속 작업이 필요한 경우 'recognitionModel' 매개 변수를 사용하여 인식 모델을 지정하세요. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 지정되면 검색된 faceId가 지정된 인식 모델과 연결됩니다. 자세한 내용은 를 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model참조하세요.

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

With optional parameters:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	검색된 faceId와 연결된 'detectionModel'입니다. 지원되는 'detectionModel' 값에는 'detection_01', 'detection_02' 및 'detection_03'가 포함됩니다. 기본값은 'detection_01'입니다.
faceIdTimeToLive	query		integer int32	캐시되는 얼굴 ID의 시간(초)입니다. 지원되는 범위는 60초에서 86400초까지입니다. 기본값은 86400(24시간)입니다.
recognitionModel	query		RecognitionModel	검색된 faceId와 연결된 '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,glasses'와 같이 쉼표로 구분된 문자열에 지정된 하나 이상의 얼굴 특성을 분석하고 반환합니다. Face 특성 분석에는 추가 계산 및 시간 비용이 있습니다.
returnFaceId	query		boolean	감지된 얼굴의 faceId를 반환합니다. 기본값은 true입니다.
returnFaceLandmarks	query		boolean	감지된 얼굴의 얼굴 랜드마크를 반환합니다. 기본값은 false입니다.
returnRecognitionModel	query		boolean	'recognitionModel' 여부를 반환합니다. 기본값은 false입니다. returnFaceId = true인 경우에만 적용됩니다.

요청 본문

Media Types: "application/octet-stream"

Name	형식	Description
imageContent	string	입력 이미지 이진입니다.

응답

Name	형식	Description
200 OK	FaceDetectionResult[]	성공적인 호출은 얼굴 사각형 크기별로 내림차순으로 순위가 지정된 얼굴 항목 배열을 반환합니다. 빈 응답은 감지된 얼굴이 없음을 나타냅니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. Headers x-ms-error-code: string

Name

형식

Description

200 OK

FaceDetectionResult[]

성공적인 호출은 얼굴 사각형 크기별로 내림차순으로 순위가 지정된 얼굴 항목 배열을 반환합니다. 빈 응답은 감지된 얼굴이 없음을 나타냅니다.

Other Status Codes

FaceErrorResponse

예기치 않은 오류 응답입니다.

Headers

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 흐름

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

예제

Detect with Image

Sample Request

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>"

Sample Response

Status code:: 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"
    }
  }
]

정의

Name	Description
AccessoryItem	액세서리 항목 및 해당 신뢰도 수준입니다.
AccessoryType	액세서리의 유형입니다.
BlurLevel	흐림 수준을 나타냅니다.
BlurProperties	이미지 내의 흐림 효과를 설명하는 속성입니다.
DetectionModel	검색된 faceId와 연결된 'detectionModel'입니다. 지원되는 'detectionModel' 값에는 'detection_01', 'detection_02' 및 'detection_03'가 포함됩니다. 기본값은 'detection_01'입니다.
ExposureLevel	노출 수준을 나타냅니다.
ExposureProperties	이미지의 노출 수준을 설명하는 속성입니다.
FaceAttributes	감지된 얼굴의 얼굴 특성입니다.
FaceAttributeType	'returnFaceAttributes=headPose,glasses'와 같이 쉼표로 구분된 문자열에 지정된 하나 이상의 얼굴 특성을 분석하고 반환합니다. Face 특성 분석에는 추가 계산 및 시간 비용이 있습니다.
FaceDetectionResult	검색 API에 대한 응답입니다.
FaceError	Error 개체. Face Service에서 반환하는 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 링크를 https://aka.ms/face-error-codes-and-messages참조하세요.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
FaceLandmarks	얼굴 구성 요소의 중요한 위치를 가리키는 27포인트 얼굴 랜드마크 컬렉션입니다.
FaceRectangle	얼굴을 찾을 수 있는 사각형입니다.
FacialHair	얼굴 머리 특성을 설명하는 속성입니다.
GlassesType	얼굴의 안경 유형입니다.
HairColor	각 항목이 있는 경우 후보 색 및 신뢰도 수준의 배열입니다.
HairColorType	머리 색의 이름입니다.
HairProperties	모발 특성을 설명하는 속성입니다.
HeadPose	얼굴 방향에 대한 3차원 롤/요/피치 각도입니다.
LandmarkCoordinate	이미지 내의 랜드마크 좌표입니다.
MaskProperties	지정된 얼굴에 마스크가 있는지 설명하는 속성입니다.
MaskType	마스크의 유형입니다.
NoiseLevel	노이즈 수준을 나타냅니다.
NoiseProperties	이미지의 노이즈 수준을 설명하는 속성입니다.
OcclusionProperties	지정된 얼굴의 폐색을 설명하는 속성입니다.
QualityForRecognition	인식할 이미지 품질을 나타냅니다.
RecognitionModel	얼굴에 대한 인식 모델입니다.

AccessoryItem

액세서리 항목 및 해당 신뢰도 수준입니다.

Name	형식	Description
confidence	number	액세서리 유형의 신뢰도 수준입니다. [0,1] 사이의 범위입니다.
type	AccessoryType	액세서리의 유형입니다.

AccessoryType

액세서리의 유형입니다.

Name	형식	Description
glasses	string	안경.
headwear	string	머리 착용.
mask	string	마스크.

BlurLevel

흐림 수준을 나타냅니다.

Name	형식	Description
high	string	높은 흐림 수준입니다.
low	string	낮은 흐림 수준입니다.
medium	string	중간 흐림 수준입니다.

BlurProperties

이미지 내의 흐림 효과를 설명하는 속성입니다.

Name	형식	Description
blurLevel	BlurLevel	흐림 수준을 나타내는 열거형 값입니다.
value	number	0에서 1 사이의 흐림 수준을 나타내는 숫자입니다.

DetectionModel

검색된 faceId와 연결된 'detectionModel'입니다. 지원되는 'detectionModel' 값에는 'detection_01', 'detection_02' 및 'detection_03'가 포함됩니다. 기본값은 'detection_01'입니다.

Name	형식	Description
detection_01	string	기본 검색 모델입니다. 가까운 정면 얼굴 감지를 권장합니다. 매우 큰 각도(머리 포즈) 얼굴, 가려진 얼굴 또는 잘못된 이미지 방향을 가진 시나리오의 경우 이러한 경우 얼굴을 감지하지 못할 수 있습니다.
detection_02	string	2019년 5월에 출시된 감지 모델은 특히 작고 측면 및 흐릿한 얼굴에서 정확도가 향상되었습니다.
detection_03	string	2021년 2월에 출시된 감지 모델은 특히 작은 얼굴에서 정확도가 향상되었습니다.

ExposureLevel

노출 수준을 나타냅니다.

Name	형식	Description
goodExposure	string	좋은 노출 수준.
overExposure	string	높은 노출 수준.
underExposure	string	낮은 노출 수준.

ExposureProperties

이미지의 노출 수준을 설명하는 속성입니다.

Name	형식	Description
exposureLevel	ExposureLevel	노출 수준을 나타내는 열거형 값입니다.
value	number	0에서 1까지의 노출 수준을 나타내는 숫자입니다. [0, 0.25) 노출 중입니다. [0.25, 0.75)는 좋은 노출입니다. [0.75, 1]이(가) 과도하게 노출되었습니다.

FaceAttributes

감지된 얼굴의 얼굴 특성입니다.

Name	형식	Description
accessories	AccessoryItem[]	지정된 얼굴의 액세서리를 설명하는 속성입니다.
age	number	년의 나이.
blur	BlurProperties	이미지 내의 흐림 효과를 설명하는 속성입니다.
exposure	ExposureProperties	이미지의 노출 수준을 설명하는 속성입니다.
facialHair	FacialHair	얼굴 머리 특성을 설명하는 속성입니다.
glasses	GlassesType	안경 유형(얼굴의 경우)입니다.
hair	HairProperties	모발 특성을 설명하는 속성입니다.
headPose	HeadPose	얼굴 방향에 대한 3차원 롤/요/피치 각도입니다.
mask	MaskProperties	지정된 얼굴에 마스크가 있는지 설명하는 속성입니다.
noise	NoiseProperties	이미지의 노이즈 수준을 설명하는 속성입니다.
occlusion	OcclusionProperties	지정된 얼굴의 폐색을 설명하는 속성입니다.
qualityForRecognition	QualityForRecognition	감지에 사용되는 이미지가 얼굴 인식을 시도할 수 있는 충분한 품질인지 여부에 대한 전반적인 이미지 품질을 설명하는 속성입니다.
smile	number	미소 강도, [0,1] 사이의 숫자입니다.

FaceAttributeType

'returnFaceAttributes=headPose,glasses'와 같이 쉼표로 구분된 문자열에 지정된 하나 이상의 얼굴 특성을 분석하고 반환합니다. Face 특성 분석에는 추가 계산 및 시간 비용이 있습니다.

Name	형식	Description
accessories	string	'모자', '안경', '마스크'를 포함한 얼굴 주위의 액세서리. 빈 배열은 감지된 액세서리가 없음을 의미합니다. 얼굴을 감지한 후입니다. 대형 마스크로 인해 얼굴을 감지할 수 없습니다.
age	string	년의 나이.
blur	string	얼굴이 흐릿하거나 흐릿하지 않습니다. Level은 'Low', 'Medium' 또는 'High'를 반환합니다. 값은 [0,1] 사이의 숫자를 반환하며 흐림이 클수록 흐려집니다.
exposure	string	얼굴 노출 수준. Level은 'GoodExposure', 'OverExposure' 또는 'UnderExposure'를 반환합니다.
facialHair	string	얼굴 머리 특성을 설명하는 속성입니다.
glasses	string	안경 유형입니다. 값으로는 'NoGlasses', 'ReadingGlasses', '선글라스', 'SwimmingGoggles'가 있습니다.
hair	string	모발 특성을 설명하는 속성입니다.
headPose	string	얼굴 방향에 대한 3차원 롤/요/피치 각도입니다.
mask	string	각 얼굴이 마스크를 쓰고 있는지 여부입니다. 마스크 형식은 'noMask', 'faceMask', 'otherMaskOrOcclusion' 또는 'uncertain'를 반환합니다. 값은 코와 입이 덮여 있는지 여부를 나타내는 부울 'noseAndMouthCovered'를 반환합니다.
noise	string	얼굴 픽셀의 노이즈 수준입니다. Level은 'Low', 'Medium' 및 'High'를 반환합니다. 값은 [0,1] 사이의 숫자를 반환하며, 더 클수록 시끄러워 옵니다.
occlusion	string	이마, 눈 및 입을 포함하여 각 얼굴 영역이 가려지는지 여부.
qualityForRecognition	string	감지에 사용되는 이미지가 얼굴 인식을 시도할 수 있는 충분한 품질인지 여부에 대한 전반적인 이미지 품질입니다. 값은 낮음, 중간 또는 높음의 비공식 등급입니다. 개인 등록에는 '높은' 품질의 이미지만 권장되며 식별 시나리오에는 '보통' 이상의 품질이 권장됩니다. 특성은 recognition_03 또는 recognition_04 인식 모델을 사용하는 경우에만 사용할 수 있습니다.
smile	string	미소 강도, [0,1] 사이의 숫자입니다.

FaceDetectionResult

검색 API에 대한 응답입니다.

Name	형식	Description
faceAttributes	FaceAttributes	감지된 얼굴의 얼굴 특성입니다.
faceId	string	검색 API에 의해 생성되고 검색 호출 후 24시간 후에 만료되는 감지된 얼굴의 고유 faceId입니다. 이를 반환하려면 'returnFaceId' 매개 변수가 true여야 합니다.
faceLandmarks	FaceLandmarks	얼굴 구성 요소의 중요한 위치를 가리키는 27포인트 얼굴 랜드마크 배열입니다. 이를 반환하려면 'returnFaceLandmarks' 매개 변수가 true여야 합니다.
faceRectangle	FaceRectangle	이미지의 얼굴 위치에 대한 사각형 영역입니다.
recognitionModel	RecognitionModel	이 faceId와 연결된 'recognitionModel'입니다. 'returnRecognitionModel'이 명시적으로 true로 설정된 경우에만 반환됩니다.

FaceError

Error 개체. Face Service에서 반환하는 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 링크를 https://aka.ms/face-error-codes-and-messages참조하세요.

Name	형식	Description
code	string	서버 정의 오류 코드 집합 중 하나입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	FaceError	Error 개체.

FaceLandmarks

얼굴 구성 요소의 중요한 위치를 가리키는 27포인트 얼굴 랜드마크 컬렉션입니다.

Name	형식	Description
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	코의 좌표는 alar 위쪽을 떠났습니다.
noseRightAlarOutTip	LandmarkCoordinate	코 오른쪽의 좌표는 팁입니다.
noseRightAlarTop	LandmarkCoordinate	코 오른쪽 알라 상단의 좌표입니다.
noseRootLeft	LandmarkCoordinate	왼쪽 코근의 좌표입니다.
noseRootRight	LandmarkCoordinate	코 루트 오른쪽의 좌표입니다.
noseTip	LandmarkCoordinate	코 끝의 좌표입니다.
pupilLeft	LandmarkCoordinate	왼쪽 눈동자의 좌표입니다.
pupilRight	LandmarkCoordinate	오른쪽 눈동자의 좌표입니다.
underLipBottom	LandmarkCoordinate	아래 립 하단의 좌표입니다.
underLipTop	LandmarkCoordinate	아래 립 탑의 좌표입니다.
upperLipBottom	LandmarkCoordinate	윗입술 아래쪽의 좌표입니다.
upperLipTop	LandmarkCoordinate	윗입술 위쪽의 좌표입니다.

FaceRectangle

얼굴을 찾을 수 있는 사각형입니다.

Name	형식	Description
height	integer	사각형의 높이(픽셀)입니다.
left	integer	이미지가 사각형의 왼쪽 가장자리까지 픽셀인 경우 왼쪽 가장자리에서의 거리입니다.
top	integer	이미지가 사각형의 위쪽 가장자리까지의 경우 위쪽 가장자리와의 거리(픽셀)입니다.
width	integer	사각형의 너비(픽셀)입니다.

FacialHair

얼굴 머리 특성을 설명하는 속성입니다.

Name	형식	Description
beard	number	속성과 연결된 신뢰도 수준을 나타내는 0에서 1 사이의 숫자입니다.
moustache	number	속성과 연결된 신뢰도 수준을 나타내는 0에서 1 사이의 숫자입니다.
sideburns	number	속성과 연결된 신뢰도 수준을 나타내는 0에서 1 사이의 숫자입니다.

GlassesType

얼굴의 안경 유형입니다.

Name	형식	Description
noGlasses	string	얼굴에 안경이 없습니다.
readingGlasses	string	얼굴에 일반 안경.
sunglasses	string	얼굴에 선글라스.
swimmingGoggles	string	얼굴에 수영 고글.

HairColor

각 항목이 있는 경우 후보 색 및 신뢰도 수준의 배열입니다.

Name	형식	Description
color	HairColorType	머리 색의 이름입니다.
confidence	number	색의 신뢰도 수준입니다. [0,1] 사이의 범위입니다.

HairColorType

머리 색의 이름입니다.

Name	형식	Description
black	string	블랙.
blond	string	금발.
brown	string	갈색.
gray	string	회색.
other	string	기타.
red	string	빨간색.
unknown	string	알 수 없습니다.
white	string	하얀.

HairProperties

모발 특성을 설명하는 속성입니다.

Name	형식	Description
bald	number	사람이 대머리인지 여부의 신뢰 수준을 설명하는 숫자입니다.
hairColor	HairColor[]	각 항목이 있는 경우 후보 색 및 신뢰도 수준의 배열입니다.
invisible	boolean	이미지에 머리카락이 표시되는지 여부를 설명하는 부울 값입니다.

HeadPose

얼굴 방향에 대한 3차원 롤/요/피치 각도입니다.

Name	형식	Description
pitch	number	각도 값입니다.
roll	number	각도 값입니다.
yaw	number	각도 값입니다.

LandmarkCoordinate

이미지 내의 랜드마크 좌표입니다.

Name	형식	Description
x	number	가로 구성 요소(픽셀)입니다.
y	number	세로 구성 요소(픽셀)입니다.

MaskProperties

지정된 얼굴에 마스크가 있는지 설명하는 속성입니다.

Name	형식	Description
noseAndMouthCovered	boolean	코와 입이 덮여 있는지 여부를 나타내는 부울 값입니다.
type	MaskType	마스크의 유형입니다.

MaskType

마스크의 유형입니다.

Name	형식	Description
faceMask	string	얼굴 마스크.
noMask	string	마스크가 없습니다.
otherMaskOrOcclusion	string	다른 유형의 마스크 또는 폐색입니다.
uncertain	string	불확 실한.

NoiseLevel

노이즈 수준을 나타냅니다.

Name	형식	Description
high	string	높은 노이즈 수준.
low	string	낮은 노이즈 수준.
medium	string	중간 노이즈 수준입니다.

NoiseProperties

이미지의 노이즈 수준을 설명하는 속성입니다.

Name	형식	Description
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

지정된 얼굴의 폐색을 설명하는 속성입니다.

Name	형식	Description
eyeOccluded	boolean	눈이 가려지는지 여부를 나타내는 부울 값입니다.
foreheadOccluded	boolean	이마가 가려지는지 여부를 나타내는 부울 값입니다.
mouthOccluded	boolean	입이 가려지는지 여부를 나타내는 부울 값입니다.

QualityForRecognition

인식할 이미지 품질을 나타냅니다.

Name	형식	Description
high	string	고품질입니다.
low	string	낮은 품질.
medium	string	중간 품질.

RecognitionModel

얼굴에 대한 인식 모델입니다.

Name	형식	Description
recognition_01	string	"검색"의 기본 인식 모델입니다. 2019년 3월 이전에 만든 모든 faceId는 이 인식 모델과 결합됩니다.
recognition_02	string	인식 모델은 2019년 3월에 출시되었습니다.
recognition_03	string	인식 모델은 2020년 5월에 출시되었습니다.
recognition_04	string	인식 모델은 2021년 2월에 출시되었습니다. 더 나은 인식 정확도를 위해 이 인식 모델을 사용하는 것이 좋습니다.

다음을 통해 공유

Face Detection Operations - Detect

URI 매개 변수

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

AADToken

Scopes

예제

Detect with Image

Sample Request

Sample Response

정의

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

추가 리소스