Emotion API とはWhat is the Emotion API?


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.

Microsoft Emotion API にようこそ。この API を使用すると、Microsoft のクラウド ベースの感情認識アルゴリズムを利用し、より個人用に設定したアプリを作成できます。Welcome to the Microsoft Emotion API, which allows you to build more personalized apps with Microsoft’s cloud-based emotion recognition algorithm.

感情認識Emotion Recognition

Emotion API ベータ版は画像を入力として取り、Face API から、画像内のそれぞれの顔について、一連の感情の信頼度と、顔の境界ボックスを返します。The Emotion API beta takes an image as an input and returns the confidence across a set of emotions for each face in the image, as well as a bounding box for the face from the Face API. 検出される感情は、喜び、悲しみ、驚き、怒り、恐怖、軽蔑、嫌悪感、中立です。The emotions detected are happiness, sadness, surprise, anger, fear, contempt, disgust, or neutral. これらの感情は、文化を問わず普遍的に、同じ基本的な顔の表情によって伝達されます。それらの表情が、Emotion API によって識別されます。These emotions are communicated cross-culturally and universally via the same basic facial expressions, where are identified by Emotion API.

結果の解釈:Interpreting Results:

Emotion API からの結果を解釈するときには、検出された感情を、最も高いスコアを持つ感情として解釈する必要があります。これは、総計が 1 になるようにスコアが正規化されるためです。In interpreting results from the Emotion API, the emotion detected should be interpreted as the emotion with the highest score, as scores are normalized to sum to one. ユーザーは必要に応じて、アプリケーション内で信頼度のしきい値をより高く設定することもできます。Users may choose to set a higher confidence threshold within their application, depending on their needs.

感情検出の詳細については、API リファレンスを参照してください。For more information about emotion detection, see the API Reference:

  • 基本: ユーザーがすでに Face API を呼び出している場合は、入力として顔矩形を送信し、基本レベルを使用することができます。Basic: If a user has already called the Face API, they can submit the face rectangle as an input and use the basic tier. API リファレンスAPI Reference
  • 標準: ユーザーが顔矩形を送信しない場合は、標準モードを使用する必要があります。Standard: If a user does not submit a face rectangle, they should use standard mode. API リファレンスAPI Reference

Emotion API を使用してストリーミング ビデオを解釈する方法のサンプルについては、「リアルタイムにビデオを分析する方法」を参照してください。For a sample on how to interpret streaming video with Emotion API, see How to Analyze Videos in Real Time.