빠른 시작: 이미지에서 얼굴의 감정을 인식하기 위한 앱을 빌드합니다.Quickstart: Build an app to recognize emotions on faces in an image.

중요

Emotion API는 2019년 2월 15일부터 더 이상 사용되지 않습니다.The Emotion API will be deprecated on February 15, 2019. 이제 감정 인식 기능은 Face API의 일부로 일반 공급됩니다.The emotion recognition capability is now generally available as part of the Face API.

이 문서에서는 cURL로 Emotion API Recognize 메서드를 빠르게 사용하여 이미지에서 한 명 이상의 사용자가 표현하는 감정을 인식하는 데 도움이 되는 정보 및 코드 샘플을 제공합니다.This article provides information and code samples to help you quickly get started using the Emotion API Recognize method with cURL to recognize the emotions expressed by one or more people in an image.

필수 요소Prerequisite

  • 여기에서 무료 구독 키 가져오기Get your free Subscription Key here

감정 인식 cURL 예제 요청Recognize Emotions cURL Example Request

참고

구독 키를 가져오는 데 사용한 것과 동일한 위치를 REST 호출에서 사용해야 합니다.You must use the same location in your REST call as you used to obtain your subscription keys. 예를 들어, westcentralus에서 구독 키를 받은 경우 아래 URL의 "westus"를 "westcentralus"로 바꿉니다.For example, if you obtained your subscription keys from westcentralus, replace "westus" in the URL below with "westcentralus".

@ECHO OFF

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

--data-ascii "{body}"

감정 인식 샘플 응답Recognize Emotions Sample Response

호출이 성공하면 얼굴 사각형 크기의 내림차순으로 얼굴 항목 및 연결된 감정 점수 배열이 반환됩니다.A successful call returns an array of face entries and their associated emotion scores, ranked by face rectangle size in descending order. 빈 응답은 검색된 얼굴이 없는 것을 나타냅니다.An empty response indicates that no faces were detected. 감정 항목에는 다음 필드가 포함됩니다.An emotion entry contains the following fields:

  • faceRectangle - 이미지에서 얼굴의 사각형 위치입니다.faceRectangle - Rectangle location of face in the image.
  • scores - 이미지의 각 얼굴에 대한 감정 점수입니다.scores - Emotion scores for each face in the image.
application/json
[
  {
    "faceRectangle": {
      "left": 68,
      "top": 97,
      "width": 64,
      "height": 97
    },
    "scores": {
      "anger": 0.00300731952,
      "contempt": 5.14648448E-08,
      "disgust": 9.180124E-06,
      "fear": 0.0001912825,
      "happiness": 0.9875571,
      "neutral": 0.0009861537,
      "sadness": 1.889955E-05,
      "surprise": 0.008229999
    }
  }
]