/mscs-face-api

Microsoft Cognitive Services Face API

Primary LanguageJavaScriptMIT LicenseMIT

mscs-face-api

Microsoft Cognitive Services Face API

Getting Started

In order to use this you need to have Node.js installed on your machine and Microsoft Cognitive Services Face API Key.

Installing

In order to install this module you need to do the following:

npm install mscs-face-api --save

Usage

First you need to require the module:

const MSCSFACEAPI = require("mscs-face-api");

After you have to create an instance of the module. You will have to specify the key and the server that you want to use. The options for the server are the following:

  • WUS (westus)
  • EUS2 (eastus2)
  • WCUS (westcentralus)
  • WE (westeurope)
  • SA (southeastasia).
var mscsfa = new MSCSFACEAPI(key,"WCUS");

Methods

In order to have a better understanding of the methods I advise you to see the documentation.

  • createPersonGroup(personGroupId, name, userData) → {Promise}
  • deletePersonGroup(personGroupId) → {Promise}
  • getPersonGroup(personGroupId) → {Promise}
  • getPersonGroupTrainingStatus(personGroupId) → {Promise}
  • listPersonGroups(start, top) → {Promise}
  • trainPersonGroup(personGroupId) → {Promise}
  • updatePersonGroup(personGroupId, name, userData) → {Promise}
  • addPersonFace(personGroupId, personId, userData, image) → {Promise}
  • createPerson(personGroupId, name, userData) → {Promise}
  • listPersonsInPersonGroup(personGroupId, start, top) → {Promise}
  • detectFace(image) → {Promise}
  • identifyFace(faceIds, personGroupId, confidenceThreshold) → {Promise}

Built With

  • Node.js - Open source server framework.
  • axios - Promise based HTTP client for the browser and node.js.

Authors

  • Daniel Matos

License

This project is licensed under the MIT License - see the LICENSE.md file for details