O que é a API de Detecção de Emoções?What is the Emotion API?

Importante

A API de Detecção de Emoções será preterida em 15 de fevereiro de 2019.The Emotion API will be deprecated on February 15, 2019. A funcionalidade de Detecção de Emoções agora está disponível como parte da API de Detecção Facial.The emotion recognition capability is now generally available as part of the Face API.

Bem-vindo à API de Detecção de Emoções da Microsoft, que permite criar aplicativos mais personalizados com o algoritmo de reconhecimento de emoções baseada em nuvem.Welcome to the Microsoft Emotion API, which allows you to build more personalized apps with Microsoft’s cloud-based emotion recognition algorithm.

Reconhecimento de emoçõesEmotion Recognition

A API de Detecção de Emoções pega uma imagem como uma entrada e retorna resultados confiáveis entre um conjunto de emoções para cada face na imagem, bem como a caixa delimitadora para a face com a API de Detecção Facial.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. As emoções detectadas são alegria, tristeza, surpresa, raiva, medo, desdém, aversão ou neutralidade.The emotions detected are happiness, sadness, surprise, anger, fear, contempt, disgust, or neutral. Esses emoções são comunicadas entre culturas e universalmente por meio das mesmas expressões faciais básicas, sendo estas identificadas pela API de Detecção de Emoções.These emotions are communicated cross-culturally and universally via the same basic facial expressions, where are identified by Emotion API.

Interpretando os resultados:Interpreting Results:

Ao interpretar os resultados da API de Detecção de Emoções, a emoção detectada deve ser interpretada como a emoção com a pontuação mais alta, pois as pontuações são normalizadas para somarem um.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. Os usuários podem optar por definir um limite de confiança superior em seus aplicativos, dependendo de suas necessidades.Users may choose to set a higher confidence threshold within their application, depending on their needs.

Para obter mais informações sobre a detecção de emoções, consulte a Referência de API:For more information about emotion detection, see the API Reference:

  • Basic: Se um usuário já chamou a API de Detecção Facial, ele pode enviar o retângulo da face como uma entrada e usar a camada Basic.Basic: If a user has already called the Face API, they can submit the face rectangle as an input and use the basic tier. Referência de APIAPI Reference
  • Standard: Se um usuário não enviar um retângulo da face, eles devem usar o modo Standard.Standard: If a user does not submit a face rectangle, they should use standard mode. Referência de APIAPI Reference

Para obter um exemplo sobre como interpretar o fluxo de vídeo com a API de Detecção de Emoções, consulte Como analisar vídeos em tempo real.For a sample on how to interpret streaming video with Emotion API, see How to Analyze Videos in Real Time.