Face API cURL 퀵 스타트

본문에서는 cURL과 Face API를 사용해서 다음과 같은 작업을 신속하게 수행하기 위해 필요한 유용한 정보와 예제 코드를 제공합니다:

• 이미지의 얼굴 감지하기
• 이미지의 얼굴 식별하기

무료 구독 키를 발급받는 방법은 구독 키 발급받기 문서를 참고하시기 바랍니다.

cURL을 이용해서 Face API로 이미지의 얼굴 감지하기

Face - Detect 메서드를 이용해서 이미지의 얼굴을 감지하고 다음과 같은 얼굴 특징을 반환받습니다:

• 얼굴 ID: 다양한 Face API 시나리오에서 사용되는 얼굴의 고유 ID
• 얼굴 사각형: 이미지 내의 얼굴 위치를 나타내는 Left, Top, Width, Height
• 랜드마크: 얼굴 구성 요소의 중요한 위치를 나타내는 27 곳의 얼굴 랜드마크 배열
• 나이, 성별, 미소짓는 정도, 머리 자세 및 얼굴의 털을 비롯한 얼굴 특징

얼굴 감지 cURL 요청 예제

@@ECHO OFF

curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect?returnFaceId=true&returnFaceLandmarks=false&returnFaceAttributes={string}"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: {subscription key}"

--data-ascii "{body}"

얼굴 감지 결과 응답 살펴보기

정상적으로 처리된 응답은 JSON 형식으로 반환됩니다. 다음은 성공한 응답의 사례입니다:

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "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.0,
        "y": 80.1 
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78.0 
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7 
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5 
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75.0 
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7 
      },
      "eyeRightBottom": {
        "x": 447.0,
        "y": 75.3 
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4 
      },
      "noseRootLeft": {
        "x": 428.0,
        "y": 77.1 
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6 
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7 
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87.0 
      },
      "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": {
      "age": 71.0,
      "gender": "male",
      "smile": 0.88,
      "facialHair": {
        "mustache": 0.8,
        "beard": 0.1,
        "sideburns": 0.02
      },
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 0
      }
    }
  }
]

cURL을 이용해서 Face API로 이미지의 얼굴 식별하기

Face - Identify 메서드를 이용해서, 미리 생성해야하고 이후 편집이 가능한 인물 데이터베이스 (인물 그룹으로 정의된) 및 감지된 얼굴에 기반해서 인물을 식별합니다.

얼굴 식별 cURL 요청 예제

@@ECHO OFF

curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/face/v1.0/identify"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: {subscription key}"

--data-ascii "{body}"

{    
  "personGroupId": "sample_group",
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "65d083d4-9447-47d1-af30-b626144bf0fb"
  ],
  "maxNumOfCandidatesReturned": 1,
  "confidenceThreshold": 0.5
}

얼굴 식별 결과 응답 살펴보기

정상적으로 처리된 응답은 JSON 형식으로 반환됩니다. 다음은 성공한 응답의 사례입니다:

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
        "confidence": 0.92
      }
    ]
  },
  {
    "faceId": "65d083d4-9447-47d1-af30-b626144bf0fb",
    "candidates": [
      {
        "personId": "2ae4935b-9659-44c3-977f-61fac20d0538",
        "confidence": 0.89
      }
    ]
  }
]