臉部 API

偵測人臉並比對類似的臉部
根據相似度將影像整理成群組
識別影像中先前所標記的人員

臉部驗證

檢查兩張臉部是屬於同一個人的可能性。API 會傳回信心分數，顯示兩張臉部是屬於同一個人的可能性。

觀看影片

為此示範上傳資料，即表示您同意 Microsoft 可儲存此資料並用其改進 Microsoft 服務，包括此 API。為了協助保護您的隱私權，我們採取了幾個步驟來取消識別您的資料並確保其安全。我們不會發佈您的資料或讓其他人使用此資料。

想要建置這個嗎？

文件

臉部偵測

偵測影像中的一或多張人臉，並取得影像臉部位置所在的臉部矩形及臉部屬性，該屬性內含以機器學習為基礎的臉部特徵預測。可用的臉部屬性功能包括：年齡、表情、性別、姿勢、微笑及鬍子，以及影像中每張臉部的 27 個地標。

觀看影片

性別	female
年齡	23.8
眼鏡	ReadingGlasses
微笑	0.826
憤怒	0.103
蔑視	0.003
討厭	0.038
恐懼	0.003
快樂	0.826
中立	0.006
憂傷	0.001
驚奇	0.02

瀏覽

偵測結果：
JSON：
 [
  {
    "faceId": "70ea78a1-ba5c-475a-a677-9f7fa9bd204c",
    "faceRectangle": {
      "top": 124,
      "left": 459,
      "width": 227,
      "height": 227
    },
    "faceAttributes": {
      "hair": {
        "bald": 0.01,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 1.0
          },
          {
            "color": "blond",
            "confidence": 0.69
          },
          {
            "color": "black",
            "confidence": 0.45
          },
          {
            "color": "other",
            "confidence": 0.32
          },
          {
            "color": "gray",
            "confidence": 0.06
          },
          {
            "color": "red",
            "confidence": 0.04
          }
        ]
      },
      "smile": 0.826,
      "headPose": {
        "pitch": 0.0,
        "roll": -16.9,
        "yaw": 21.3
      },
      "gender": "female",
      "age": 23.8,
      "facialHair": {
        "moustache": 0.0,
        "beard": 0.0,
        "sideburns": 0.0
      },
      "glasses": "ReadingGlasses",
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": true
      },
      "emotion": {
        "anger": 0.103,
        "contempt": 0.003,
        "disgust": 0.038,
        "fear": 0.003,
        "happiness": 0.826,
        "neutral": 0.006,
        "sadness": 0.001,
        "surprise": 0.02
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "glasses",
          "confidence": 0.99
        }
      ],
      "blur": {
        "blurLevel": "low",
        "value": 0.0
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.48
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.11
      }
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 504.4,
        "y": 202.8
      },
      "pupilRight": {
        "x": 607.7,
        "y": 175.9
      },
      "noseTip": {
        "x": 598.5,
        "y": 250.9
      },
      "mouthLeft": {
        "x": 527.7,
        "y": 298.9
      },
      "mouthRight": {
        "x": 626.4,
        "y": 271.5
      },
      "eyebrowLeftOuter": {
        "x": 452.3,
        "y": 191.0
      },
      "eyebrowLeftInner": {
        "x": 531.4,
        "y": 180.2
      },
      "eyeLeftOuter": {
        "x": 487.6,
        "y": 207.9
      },
      "eyeLeftTop": {
        "x": 506.7,
        "y": 196.6
      },
      "eyeLeftBottom": {
        "x": 506.8,
        "y": 212.9
      },
      "eyeLeftInner": {
        "x": 526.5,
        "y": 204.3
      },
      "eyebrowRightInner": {
        "x": 583.7,
        "y": 167.6
      },
      "eyebrowRightOuter": {
        "x": 635.8,
        "y": 141.4
      },
      "eyeRightInner": {
        "x": 592.0,
        "y": 185.0
      },
      "eyeRightTop": {
        "x": 607.3,
        "y": 170.1
      },
      "eyeRightBottom": {
        "x": 612.2,
        "y": 183.4
      },
      "eyeRightOuter": {
        "x": 626.6,
        "y": 171.7
      },
      "noseRootLeft": {
        "x": 549.7,
        "y": 201.0
      },
      "noseRootRight": {
        "x": 581.7,
        "y": 192.9
      },
      "noseLeftAlarTop": {
        "x": 557.5,
        "y": 241.1
      },
      "noseRightAlarTop": {
        "x": 603.7,
        "y": 228.5
      },
      "noseLeftAlarOutTip": {
        "x": 549.4,
        "y": 261.8
      },
      "noseRightAlarOutTip": {
        "x": 616.7,
        "y": 241.7
      },
      "upperLipTop": {
        "x": 593.2,
        "y": 283.5
      },
      "upperLipBottom": {
        "x": 594.1,
        "y": 291.6
      },
      "underLipTop": {
        "x": 595.6,
        "y": 307.0
      },
      "underLipBottom": {
        "x": 598.0,
        "y": 320.7
      }
    }
  }
]