Skip Navigation
  1. Home
  4. Face

Face

Try Face

Try Cognitive Services for free

Guest

7-day trial

Evaluate Cognitive Services for free

  • No credit card required
  • No data saved after trial

Free Azure account

$0/month

Try with an Azure free account

Sign up
  • Get $200 in credits on Azure
  • Free access that never expires
  • Data and customizations saved

Existing Azure account

Already have an Azure account?

Sign in
  • Full SLA report
  • Enterprise grade performance
  • Full Azure product integration
  • Scale up seamlessly as needed

Try Cognitive Services for free

1/3

Microsoft Cognitive Services Terms

Please review the service terms for your free trial.

Microsoft may contact me about Azure and other Microsoft products and services. You can unsubscribe at any time. To learn more you can read the privacy statement.
Recognize faces on the edge, on premises, and in the cloud using containers. Learn more

Face verification

Check the likelihood that two faces belong to the same person. The API will return a confidence score about how likely it is that the two faces belong to one person.

See it in action

Verification result: The two faces belong to the same person. Confidence is 0.92199.

Want to build this?

Documentation

Face detection

Detect one or more human faces in an image and get back face rectangles for where in the image the faces are, along with face attributes which contain machine learning-based predictions of facial features. The face attribute features available are: Age, Emotion, Gender, Pose, Smile, and Facial Hair along with 27 landmarks for each face in the image.

See it in action

Gender female
Age 24
Glasses ReadingGlasses
Emotion Happiness 
Detection result:
JSON:
 [
  {
    "faceId": "ccd837eb-bfb2-4a10-8c86-d9b3a358ebd5",
    "faceRectangle": {
      "top": 128,
      "left": 459,
      "width": 224,
      "height": 224
    },
    "faceAttributes": {
      "hair": {
        "bald": 0.1,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 0.99
          },
          {
            "color": "black",
            "confidence": 0.57
          },
          {
            "color": "red",
            "confidence": 0.36
          },
          {
            "color": "blond",
            "confidence": 0.34
          },
          {
            "color": "gray",
            "confidence": 0.15
          },
          {
            "color": "other",
            "confidence": 0.13
          }
        ]
      },
      "smile": 1.0,
      "headPose": {
        "pitch": -13.2,
        "roll": -11.9,
        "yaw": 5.0
      },
      "gender": "female",
      "age": 24.0,
      "facialHair": {
        "moustache": 0.0,
        "beard": 0.0,
        "sideburns": 0.0
      },
      "glasses": "ReadingGlasses",
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": true
      },
      "emotion": {
        "anger": 0.0,
        "contempt": 0.0,
        "disgust": 0.0,
        "fear": 0.0,
        "happiness": 1.0,
        "neutral": 0.0,
        "sadness": 0.0,
        "surprise": 0.0
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "glasses",
          "confidence": 1.0
        }
      ],
      "blur": {
        "blurLevel": "low",
        "value": 0.0
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.48
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.0
      }
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 504.8,
        "y": 206.8
      },
      "pupilRight": {
        "x": 602.5,
        "y": 178.4
      },
      "noseTip": {
        "x": 593.5,
        "y": 247.3
      },
      "mouthLeft": {
        "x": 529.8,
        "y": 300.5
      },
      "mouthRight": {
        "x": 626.0,
        "y": 277.3
      },
      "eyebrowLeftOuter": {
        "x": 461.0,
        "y": 186.8
      },
      "eyebrowLeftInner": {
        "x": 541.9,
        "y": 178.9
      },
      "eyeLeftOuter": {
        "x": 490.9,
        "y": 209.0
      },
      "eyeLeftTop": {
        "x": 509.1,
        "y": 199.5
      },
      "eyeLeftBottom": {
        "x": 509.3,
        "y": 213.9
      },
      "eyeLeftInner": {
        "x": 529.0,
        "y": 205.0
      },
      "eyebrowRightInner": {
        "x": 579.2,
        "y": 169.2
      },
      "eyebrowRightOuter": {
        "x": 633.0,
        "y": 136.4
      },
      "eyeRightInner": {
        "x": 590.5,
        "y": 184.5
      },
      "eyeRightTop": {
        "x": 604.2,
        "y": 171.5
      },
      "eyeRightBottom": {
        "x": 608.4,
        "y": 184.0
      },
      "eyeRightOuter": {
        "x": 623.8,
        "y": 173.7
      },
      "noseRootLeft": {
        "x": 549.8,
        "y": 200.3
      },
      "noseRootRight": {
        "x": 580.7,
        "y": 192.3
      },
      "noseLeftAlarTop": {
        "x": 557.2,
        "y": 234.6
      },
      "noseRightAlarTop": {
        "x": 603.2,
        "y": 225.1
      },
      "noseLeftAlarOutTip": {
        "x": 545.4,
        "y": 255.5
      },
      "noseRightAlarOutTip": {
        "x": 615.9,
        "y": 239.5
      },
      "upperLipTop": {
        "x": 591.1,
        "y": 278.4
      },
      "upperLipBottom": {
        "x": 593.2,
        "y": 288.7
      },
      "underLipTop": {
        "x": 597.1,
        "y": 308.0
      },
      "underLipBottom": {
        "x": 600.3,
        "y": 324.8
      }
    }
  }
]

Want to build this?

Documentation

Emotion recognition

The Face API now integrates emotion recognition, returning the confidence across a set of emotions for each face in the image such as anger, contempt, disgust, fear, happiness, neutral, sadness, and surprise. These emotions are understood to be cross-culturally and universally communicated with particular facial expressions.

See it in action

Anger 0.00000
Contempt 0.00000
Disgust 0.00000
Fear 0.00000
Happiness 0.19600
Neutral 0.00000
Sadness 0.00000
Surprise 0.80300 
Detection result:
1 faces detected

 JSON:
 [
  {
    "faceRectangle": {
      "top": 141,
      "left": 130,
      "width": 162,
      "height": 162
    },
    "faceAttributes": {
      "emotion": {
        "anger": 0.0,
        "contempt": 0.0,
        "disgust": 0.0,
        "fear": 0.0,
        "happiness": 0.196,
        "neutral": 0.0,
        "sadness": 0.0,
        "surprise": 0.803
      }
    }
  }
]

Want to build this?

Documentation

Face identification

Face API enables you to search, identify, and match faces in your private repository of up to 1 million people.

Similar face search

Easily find similar-looking faces. Given a collection of faces and a new face as a query, this API will return a collection of similar faces.

Face grouping

Organize many unidentified faces together into groups, based on their visual similarity.

  1. Cloudinary
  2. GrayMeta
  3. Prism Skylabs
  4. Uber
  5. Pic Collage
  6. Pivothead

"By enhancing our service with the Face API, we have a competitive advantage in markets that demand a high degree of facial detection accuracy."

Daniel Amitai: Vice President of Business Development | Cloudinary
Cloudinary

"Because the Cognitive Services APIs harness the power of machine learning, we were able to bring advanced intelligence into our product without the need to have a team of data scientists on hand."

Aaron Edell: Chief Product Owner | GrayMeta
GrayMeta

"We found Cognitive Services to be the missing piece in the equation, the one that we needed to bring this solution to market and really revolutionize the way people look at video."

Katie McCann: Vice President of Product and Engineering | Prism Skylabs
Prism Skylabs

"Thousands of partners sign in to our platform every hour. The response time from the Face API is incredible, enabling us to verify our drivers without slowing them down."

Dima Kovalev: Product Manager | Uber
Uber

"It didn't take us long to realize Microsoft Cognitive Services had handed us a powerful set of computer-vision and artificial-intelligence tools that we could use to create great apps and new features for our customers in just a few hours."

John Fan: Cofounder and CEO | Cardinal Blue Software
Pic Collage

"Using the Cognitive Services APIs, it took us three months to develop a test pair of glasses that can translate text and images into speech, identify emotions, and describe scenery. If we had been working full time, we could have done it in two weeks."

Benoit Chirouter: R&D Director | Pivothead
Pivothead

Learn more

Resources

Explore the Cognitive Services APIs

  1. Vision
  2. Speech
  3. Language
  4. Decision
  5. Search

Computer Vision

Distill actionable information from images

Face

Detect, identify, analyze, organize, and tag faces in photos

Ink Recognizer PREVIEW

An AI service that recognizes digital ink content, such as handwriting, shapes, and ink document layout

Video Indexer

Unlock video insights

Custom Vision

Easily customize your own state-of-the-art computer vision models for your unique use case

Form Recognizer PREVIEW

The AI-powered document extraction service that understands your forms

Text Analytics

Easily evaluate sentiment and topics to understand what users want

Translator Text

Easily conduct machine translation with a simple REST API call

QnA Maker

Distill information into conversational, easy-to-navigate answers

Language Understanding

Teach your apps to understand commands from your users

Immersive Reader PREVIEW

Empower users of all ages and abilities to read and comprehend text

Speech Services

Unified speech services for speech-to-text, text-to-speech and speech translation

Speaker Recognition PREVIEW

Use speech to identify and verify individual speakers

Content Moderator

Automated image, text, and video moderation

Anomaly Detector PREVIEW

Easily add anomaly detection capabilities to your apps.

Personalizer PREVIEW

An AI service that delivers a personalized user experience

Ready to supercharge your app?