Face API

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.7349.

By uploading data for this demo you agree that Microsoft may store it and use it to improve Microsoft services, such as making this API better. To help protect your privacy, we take steps to de-identify your data and keep it secure. We won’t publish your data or let other people use it.

Want to build this?

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 39.3
Glasses NoGlasses
Smile 1
Anger 0
Contempt 0
Disgust 0
Fear 0
Happiness 1
Neurtral 0
Sadness 0
Surprise 0
Gender female
Age 22.5
Glasses NoGlasses
Smile 0.995
Anger 0.001
Contempt 0
Disgust 0
Fear 0
Happiness 0.995
Neurtral 0.003
Sadness 0.001
Surprise 0
Detection result:
JSON:
[ { "FaceId": "3f9c7175-046e-4497-b55b-6cea2559043b", "FaceRectangle": { "Top": 130, "Left": 231, "Width": 62, "Height": 62 }, "FaceAttributes": { "Smile": 1.0, "HeadPose": { "Pitch": 0.0, "Roll": 0.2, "Yaw": 22.9 }, "Gender": "female", "Age": 39.3, "FacialHair": { "Moustache": 0.0, "Beard": 0.0, "Sideburns": 0.0 }, "Glasses": "NoGlasses", "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 } }, "FaceLandmarks": { "PupilLeft": { "X": 248.0, "Y": 146.9 }, "PupilRight": { "X": 274.8, "Y": 146.1 }, "NoseTip": { "X": 267.0, "Y": 165.1 }, "MouthLeft": { "X": 245.1, "Y": 174.6 }, "MouthRight": { "X": 272.6, "Y": 174.2 }, "EyebrowLeftOuter": { "X": 234.5, "Y": 139.8 }, "EyebrowLeftInner": { "X": 259.3, "Y": 138.3 }, "EyeLeftOuter": { "X": 243.6, "Y": 146.6 }, "EyeLeftTop": { "X": 248.1, "Y": 145.4 }, "EyeLeftBottom": { "X": 247.9, "Y": 147.4 }, "EyeLeftInner": { "X": 252.6, "Y": 147.4 }, "EyebrowRightInner": { "X": 269.3, "Y": 138.5 }, "EyebrowRightOuter": { "X": 286.4, "Y": 137.9 }, "EyeRightInner": { "X": 270.7, "Y": 146.2 }, "EyeRightTop": { "X": 275.6, "Y": 144.9 }, "EyeRightBottom": { "X": 275.4, "Y": 146.9 }, "EyeRightOuter": { "X": 278.9, "Y": 146.0 }, "NoseRootLeft": { "X": 259.0, "Y": 146.8 }, "NoseRootRight": { "X": 268.1, "Y": 146.8 }, "NoseLeftAlarTop": { "X": 257.3, "Y": 159.1 }, "NoseRightAlarTop": { "X": 270.8, "Y": 158.6 }, "NoseLeftAlarOutTip": { "X": 252.3, "Y": 164.5 }, "NoseRightAlarOutTip": { "X": 274.1, "Y": 164.6 }, "UpperLipTop": { "X": 262.0, "Y": 173.0 }, "UpperLipBottom": { "X": 261.5, "Y": 175.4 }, "UnderLipTop": { "X": 261.2, "Y": 178.9 }, "UnderLipBottom": { "X": 261.2, "Y": 183.3 } } }, { "FaceId": "81784332-b492-47a7-82ae-76be043a5345", "FaceRectangle": { "Top": 149, "Left": 339, "Width": 57, "Height": 57 }, "FaceAttributes": { "Smile": 0.995, "HeadPose": { "Pitch": 0.0, "Roll": 4.9, "Yaw": 2.5 }, "Gender": "female", "Age": 22.5, "FacialHair": { "Moustache": 0.0, "Beard": 0.0, "Sideburns": 0.0 }, "Glasses": "NoGlasses", "Emotion": { "Anger": 0.001, "Contempt": 0.0, "Disgust": 0.0, "Fear": 0.0, "Happiness": 0.995, "Neutral": 0.003, "Sadness": 0.001, "Surprise": 0.0 } }, "FaceLandmarks": { "PupilLeft": { "X": 355.3, "Y": 163.8 }, "PupilRight": { "X": 382.3, "Y": 166.2 }, "NoseTip": { "X": 368.3, "Y": 182.4 }, "MouthLeft": { "X": 354.2, "Y": 189.3 }, "MouthRight": { "X": 378.2, "Y": 191.4 }, "EyebrowLeftOuter": { "X": 341.6, "Y": 154.0 }, "EyebrowLeftInner": { "X": 360.9, "Y": 159.9 }, "EyeLeftOuter": { "X": 348.9, "Y": 162.6 }, "EyeLeftTop": { "X": 354.5, "Y": 162.6 }, "EyeLeftBottom": { "X": 353.7, "Y": 165.4 }, "EyeLeftInner": { "X": 359.0, "Y": 164.5 }, "EyebrowRightInner": { "X": 376.1, "Y": 160.2 }, "EyebrowRightOuter": { "X": 396.7, "Y": 160.3 }, "EyeRightInner": { "X": 377.6, "Y": 166.1 }, "EyeRightTop": { "X": 382.6, "Y": 164.8 }, "EyeRightBottom": { "X": 382.2, "Y": 168.2 }, "EyeRightOuter": { "X": 386.9, "Y": 166.4 }, "NoseRootLeft": { "X": 364.0, "Y": 165.8 }, "NoseRootRight": { "X": 372.9, "Y": 166.4 }, "NoseLeftAlarTop": { "X": 361.6, "Y": 175.6 }, "NoseRightAlarTop": { "X": 374.4, "Y": 176.1 }, "NoseLeftAlarOutTip": { "X": 358.6, "Y": 180.8 }, "NoseRightAlarOutTip": { "X": 376.5, "Y": 181.7 }, "UpperLipTop": { "X": 366.8, "Y": 191.5 }, "UpperLipBottom": { "X": 366.4, "Y": 193.2 }, "UnderLipTop": { "X": 365.6, "Y": 194.4 }, "UnderLipBottom": { "X": 365.7, "Y": 197.6 } } } ]

By uploading data for this demo you agree that Microsoft may store it and use it to improve Microsoft services, such as making this API better. To help protect your privacy, we take steps to de-identify your data and keep it secure. We won’t publish your data or let other people use it.

Want to build this?

Face identification

Search and identify faces. Tag people and groups with user-provided data and then search those for a match with previously unseen faces.

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.

Check out the other Cognitive Services APIs

Computer Vision API

Distill actionable information from images

Content Moderator

Automated image, text, and video moderation

Video API PREVIEW

Intelligent video processing

Video Indexer PREVIEW

Unlock video insights

Face API

Detect, analyze, organize, and tag faces in photos

Emotion API PREVIEW

Personalize user experiences with emotion recognition

Custom Vision Service PREVIEW

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

Language Understanding Intelligent Service PREVIEW

Teach your apps to understand commands from your users

Bing Spell Check API

Detect and correct spelling mistakes in your app

Web Language Model API PREVIEW

Use the power of predictive language models trained on web-scale data

Translator Speech API

Easily conduct real-time speech translation with a simple REST API call

Text Analytics API PREVIEW

Easily evaluate sentiment and topics to understand what users want

Translator Text API

Easily conduct machine translation with a simple REST API call

Linguistic Analysis API PREVIEW

Simplify complex language concepts and parse text with the Linguistic Analysis API.

Custom Speech Service PREVIEW

Overcome speech recognition barriers like speaking style, background noise, and vocabulary

Bing Speech API

Convert speech to text and back again to understand user intent

Speaker Recognition API PREVIEW

Use speech to identify and authenticate individual speakers

Recommendations API PREVIEW

Predict and recommend items your customers want

Knowledge Exploration Service PREVIEW

Enable interactive search experiences over structured data via natural language inputs

Entity Linking Intelligence Service API PREVIEW

Power your app's data links with named entity recognition and disambiguation.

Academic Knowledge API

Tap into the wealth of academic content in the Microsoft Academic Graph

QnA Maker API PREVIEW

Distill information into conversational, easy-to-navigate answers.

Custom Decision Service PREVIEW

A cloud-based, contextual decision-making API that sharpens with experience

Project Prague

Gesture based controls

Nanjing Project

Isochrones Calculations

Project Johannesburg

Route logistics

Project Cuzco

Event associated with Wikipedia Entries

Project Abu Dhabi

Distance Matrix

Project Wollongong

Location insights

Ready to supercharge your app?