Face Detection Operations - Detect From Session Image Id

참조

서비스:: Azure AI Services

API 버전:: v1.2-preview.1

이미지에서 사람 얼굴을 감지하고, 얼굴 사각형을 반환하고, 필요에 따라 faceId, 랜드마크 및 특성을 사용합니다.

중요하다

Microsoft는 감정 상태 및 ID 특성을 유추하는 데 사용할 수 있는 사용 중지되거나 제한된 얼굴 인식 기능을 보유하고 있으며, 오용될 경우 사람들이 스테레오티핑, 차별 또는 불공정한 서비스 거부를 받을 수 있습니다. 은퇴 한 기능은 감정과 성별입니다. 제한된 기능은 나이, 미소, 얼굴 머리, 머리와 메이크업입니다. 제한된 기능을 사용하는 데 도움이 되는 책임 있는 사용 사례가 있는 경우 Azure Face API azureface@microsoft.com 이메일을 보냅니다. 이 결정 https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/대해 자세히 알아보세요.

- 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 서버에 저장됩니다. faceId는 얼굴 기능의 식별자이며 "식별", "확인" 및 "유사 항목 찾기"에 사용됩니다. 저장된 얼굴 기능은 원래 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료되고 삭제됩니다.
- 선택적 매개 변수에는 faceId, 랜드마크 및 특성이 포함됩니다. 특성에는 헤드포즈, 안경, 폐색, 액세서리, 흐림, 노출, 노이즈, 마스크 및 QualityForRecognition이 포함됩니다. 특정 특성에 대해 반환된 결과 중 일부는 매우 정확하지 않을 수 있습니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 이미지에 대해 최대 100명의 얼굴을 반환할 수 있습니다. 얼굴은 큰 사각형 크기에서 작은 크기로 순위가 매겨집니다.
- "식별", "확인" 및 "유사 항목 찾기"('returnFaceId'는 true)를 쿼리할 때 최적의 결과를 얻으려면 정면, 지우기 및 최소 크기가 200x200픽셀(눈 사이의 100픽셀)인 얼굴을 사용하세요.
- 다른 'detectionModel' 값을 제공할 수 있습니다. 다른 검색 모델을 사용하고 비교하려면 https://zcusa.951200.xyz/azure/ai-services/computer-vision/how-to/specify-detection-model 참조하세요.
  - 'detection_02': 이 검색 모델을 선택하면 얼굴 특성 및 랜드마크가 비활성화됩니다.
  - 'detection_03': 이 검색 모델을 선택하면 얼굴 특성(마스크, 흐림, 헤드포즈) 및 랜드마크가 지원됩니다.
- 다른 'recognitionModel' 값이 제공됩니다. "Verify", "Identify", "Find Similar"와 같은 후속 작업이 필요한 경우 인식 모델을 'recognitionModel' 매개 변수로 지정하세요. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 지정되면 검색된 faceId가 지정된 인식 모델과 연결됩니다. 자세한 내용은 https://zcusa.951200.xyz/azure/ai-services/computer-vision/how-to/specify-recognition-model참조하세요.

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

선택적 매개 변수:

POST {endpoint}/face/{apiVersion}/detect?_overload=detectFromSessionImageId&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'와 같이 쉼표로 구분된 문자열에서 하나 이상의 지정된 얼굴 특성을 분석하고 반환합니다. 얼굴 특성 분석에는 추가 계산 및 시간 비용이 있습니다.
returnFaceId	query		boolean	감지된 얼굴의 faceId를 반환합니다. 기본값은 true입니다.
returnFaceLandmarks	query		boolean	감지된 얼굴의 얼굴 랜드마크를 반환합니다. 기본값은 false입니다.
returnRecognitionModel	query		boolean	'recognitionModel'을 반환합니다. 기본값은 false입니다. returnFaceId = true인 경우에만 적용됩니다.

요청 본문

Name	필수	형식	Description
sessionImageId	True	string	세션 이미지의 ID입니다.

응답

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

Name

형식

Description

200 OK

FaceDetectionResult[]

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

Other Status Codes

FaceErrorResponse

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

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

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

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

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

예제

Detect From Session Image Id

샘플 요청

HTTP

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

{
  "sessionImageId": "aa93ce80-9a9b-48bd-ae1a-1c7543841e92"
}

샘플 응답

상태 코드:: 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'와 같이 쉼표로 구분된 문자열에서 하나 이상의 지정된 얼굴 특성을 분석하고 반환합니다. 얼굴 특성 분석에는 추가 계산 및 시간 비용이 있습니다.
FaceDetectionResult	API 검색에 대한 응답입니다.
FaceError	오류 개체입니다. 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'와 같이 쉼표로 구분된 문자열에서 하나 이상의 지정된 얼굴 특성을 분석하고 반환합니다. 얼굴 특성 분석에는 추가 계산 및 시간 비용이 있습니다.

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

FaceError

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

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

FaceErrorResponse

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

Name	형식	Description
error	FaceError	오류 개체입니다.

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	코의 좌표는 아라 상단 왼쪽입니다.
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	"Detect"의 기본 인식 모델입니다. 2019년 3월 이전에 만든 모든 faceId는 이 인식 모델과 결합됩니다.
recognition_02	string	인식 모델은 2019년 3월에 출시되었습니다.
recognition_03	string	인식 모델은 2020년 5월에 출시됩니다.
recognition_04	string	인식 모델은 2021년 2월에 출시되었습니다. 더 나은 인식 정확도를 위해 이 인식 모델을 사용하는 것이 좋습니다.

다음을 통해 공유

Face Detection Operations - Detect From Session Image Id

URI 매개 변수

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

AADToken

범위

예제

Detect From Session Image Id

샘플 요청

샘플 응답

정의

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

추가 리소스