빠른 시작: Face REST API 및 cURL을 사용하여 이미지에서 얼굴 감지Quickstart: Detect faces in an image using the Face REST API and cURL

이 빠른 시작에서는 이미지에서 사람 얼굴을 감지하기 위해 cURL과 함께 Azure Face REST API를 사용합니다.In this quickstart, you will use the Azure Face REST API with cURL to detect human faces in an image.

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

필수 조건Prerequisites

명령 작성Write the command

다음과 같은 명령을 사용하여 Face API를 호출하고 이미지에서 얼굴 특성 데이터를 가져옵니다.You will use a command like the following to call the Face API and get face attribute data from an image. 먼저, 텍스트 편집기에 코드를 복사합니다. 코드를 명령의 특정 부분으로 변경해야 실행할 수 있습니다.—First, copy the code into a text editor—you'll need to make changes to certain parts of the command before you can run it.

curl -H "Ocp-Apim-Subscription-Key: <Subscription Key>" "https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect?returnFaceId=true&returnFaceLandmarks=false&returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise" -H "Content-Type: application/json" --data-ascii "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/c/c3/RH_Louise_Lillian_Gish.jpg\"}"

구독 키Subscription key

<Subscription Key>를 유효한 Face 구독 키로 바꿉니다.Replace <Subscription Key> with your valid Face subscription key.

Face 엔드포인트 URLFace endpoint URL

URL https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect는 쿼리할 Azure Face 엔드포인트를 나타냅니다.The URL https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect indicates the Azure Face endpoint to query. 이 URL의 첫 번째 부분을 사용자 구독 키에 해당하는 지역에 맞게 변경해야 합니다(모든 지역 엔드포인트 목록을 보려면 Face API 설명서 참조).You may need to change the first part of this URL to match the region that corresponds to your subscription key (see the Face API docs for a list of all region endpoints).

URL 쿼리 문자열URL query string

Face 엔드포인트 URL의 쿼리 문자열은 검색할 얼굴 특성을 지정합니다.The query string of the Face endpoint URL specifies which face attributes to retrieve. 의도된 용도에 따라 이 문자열을 변경하려고 할 수 있습니다.You may wish to change this string depending on your intended use.

?returnFaceId=true&returnFaceLandmarks=false&returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise

이미지 원본 URLImage source URL

소스 URL은 입력으로 사용할 이미지를 나타냅니다.The source URL indicates the image to use as input. 이것은 분석하려는 이미지를 가리키도록 변경할 수 있습니다.You can change this to point to any image you wish to analyze.

https://upload.wikimedia.org/wikipedia/commons/c/c3/RH_Louise_Lillian_Gish.jpg

명령 실행Run the command

변경한 후에는 명령 프롬프트를 열고 새 명령을 입력합니다.Once you've made your changes, open a command prompt and enter the new command. 콘솔 창에 얼굴 정보가 JSON 데이터로 표시됩니다.You should see the face information displayed as JSON data in the console window. 예: For example:

[
  {
    "faceId": "49d55c17-e018-4a42-ba7b-8cbbdfae7c6f",
    "faceRectangle": {
      "top": 131,
      "left": 177,
      "width": 162,
      "height": 162
    },
    "faceAttributes": {
      "smile": 0,
      "headPose": {
        "pitch": 0,
        "roll": 0.1,
        "yaw": -32.9
      },
      "gender": "female",
      "age": 22.9,
      "facialHair": {
        "moustache": 0,
        "beard": 0,
        "sideburns": 0
      },
      "glasses": "NoGlasses",
      "emotion": {
        "anger": 0,
        "contempt": 0,
        "disgust": 0,
        "fear": 0,
        "happiness": 0,
        "neutral": 0.986,
        "sadness": 0.009,
        "surprise": 0.005
      },
      "blur": {
        "blurLevel": "low",
        "value": 0.06
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.67
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0
      },
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": true
      },
      "accessories": [],
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "hair": {
        "bald": 0,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 1
          },
          {
            "color": "black",
            "confidence": 0.87
          },
          {
            "color": "other",
            "confidence": 0.51
          },
          {
            "color": "blond",
            "confidence": 0.08
          },
          {
            "color": "red",
            "confidence": 0.08
          },
          {
            "color": "gray",
            "confidence": 0.02
          }
        ]
      }
    }
  }
]

다음 단계Next steps

이 빠른 시작에서는 Azure Face API를 호출하는 cURL 명령을 작성하여 이미지에서 얼굴을 감지하고 속성을 반환했습니다.In this quickstart, you wrote a cURL command that calls the Azure Face API to detect faces in an image and return their attributes. 다음에는 Face API 참조 설명서를 살펴보고 보다 자세히 알아보겠습니다.Next, explore the Face API reference documentation to learn more.