Guides

Image Emotion Recognition

This addon uses Machine Learning to classify emotions of each face (if any) in an image asset. This is a multi-label classification and the API returns a list of possible emotions and their confidence scores for each face.

🚧

Note: This API is not generally available. Please contact us to get access to this API.

📘

For training custom emotion labels, please contact your FileSpin representative.

Note

  • This API can be used to automatically update Asset metadata with the labels under a reserved field named _filespin_emotion_labels using the update_metadata disposition option.
  • When an asset is updated for the reserved field named _filespin_emotion_labels, this field value will be automatically indexed for search.
  • If your asset schema is defined to have _filespin_emotion_labels, ensure that this is a string type field and the maxLength is set to atleast 100, like below:-
    "_filespin_emotion_labels": {
            "title": "Emotions detected",
            "type": "string",
            "description": "Possible emotions detected",
            "minLength": 0,
            "maxLength": 100,
            "filespin_properties": {
              "title": {
                "en": "Emotion detected"
              },
              "hint": {
                "en": "Emotion detected"
              },
              "placeholder": {
                "en": "Emotion detected"
              },
              "searchable": true,
              "keyword_searchable": true,
              "filterable": false,
              "facetable": false,
              "ui": {
                "order": 36,
                "readonly": false,
                "disabled": false,
                "hidden": false
              }
            }
          }