Face Detection Operations - Detect

Referenz

Dienst:: Azure AI Services

API-Version:: v1.2-preview.1

Erkennen von menschlichen Gesichtern in einem Bild, Zurückgeben von Gesichtsrechtecken und optional mit FaceIds, Landmarks und Attributen.

Wichtig

Microsoft verfügt über eingestellte oder eingeschränkte Gesichtserkennungsfunktionen, die verwendet werden können, um emotionale Zustände und Identitätsattribute zu ableiten, die Personen unter Stereotypisierung, Diskriminierung oder unfaire Verweigerung von Diensten unterwerfen können. Die eingestellten Fähigkeiten sind Emotion und Geschlecht. Die begrenzten Fähigkeiten sind Alter, Lächeln, Gesichtshaare, Haare und Make-up. Mail Azure Face API azureface@microsoft.com, wenn Sie über einen verantwortungsvollen Anwendungsfall verfügen, der von der Verwendung einer der eingeschränkten Funktionen profitieren würde. Weitere Informationen zu dieser Entscheidung https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Es wird kein Bild gespeichert. Nur die extrahierten Gesichtsfeatures werden auf dem Server gespeichert. Die faceId ist ein Bezeichner des Gesichtsfeatures und wird in "Identifizieren", "Überprüfen" und "Ähnliche Suchen" verwendet. Die gespeicherten Gesichtsfeatures laufen ab und werden nach dem ursprünglichen Erkennungsaufruf nach faceIdTimeToLive gelöscht.
- Optionale Parameter umfassen faceId, Landmarks und Attribute. Zu den Attributen gehören HeadPose, Brille, Okklusion, Zubehör, Weichzeichner, Belichtung, Rauschen, Masken und QualitätForRecognition. Einige der ergebnisse, die für bestimmte Attribute zurückgegeben werden, sind möglicherweise nicht sehr genau.
- JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB.
- Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße.
- Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden nach der Größe des Gesichtsrechtecks von groß bis klein bewertet.
- Um optimale Ergebnisse beim Abfragen von "Identify", "Verify" und "Find Similar" ('returnFaceId' ist wahr) zu erzielen, verwenden Sie bitte Gesichter, die folgendes sind: Frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen).
- Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - "detection_02": Gesichtsattribute und Landmarks sind deaktiviert, wenn Sie dieses Erkennungsmodell auswählen.
  - 'detection_03': Gesichtsattribute (Masken, Weichzeichner und HeadPose) und Landmarks werden unterstützt, wenn Sie dieses Erkennungsmodell auswählen.
- Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Nachverfolgungsvorgänge wie "Verify", "Identify", "Find Similar" erforderlich sind, geben Sie das Erkennungsmodell mit dem Parameter "recognitionModel" an. Der Standardwert für "recognitionModel" ist "recognition_01", falls das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Details finden Sie unter https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

POST {endpoint}/face/{apiVersion}/detect

Mit optionalen Parametern:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
apiVersion	path	True	string	API-Version
endpoint	path	True	string uri	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte 'detectionModel'-Werte umfassen "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
faceIdTimeToLive	query		integer int32	Die Anzahl der Sekunden für die Zwischenspeicherung der Gesichts-ID. Unterstützter Bereich von 60 Sekunden bis zu 86400 Sekunden. Der Standardwert ist 86400 (24 Stunden).
recognitionModel	query		RecognitionModel	Das "recognitionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte 'recognitionModel'-Werte umfassen 'recognition_01', 'recognition_02', 'recognition_03' oder 'recognition_04'. Der Standardwert ist "recognition_01". "recognition_04" wird empfohlen, da die Genauigkeit bei Gesichtern mit Masken im Vergleich zu "recognition_03" verbessert wird und die Gesamtgenauigkeit im Vergleich zu "recognition_01" und "recognition_02" verbessert wird.
returnFaceAttributes	query		FaceAttributeType[]	Analysieren und zurückgeben Sie die angegebenen Gesichtsattribute in der durch Trennzeichen getrennten Zeichenfolge wie "returnFaceAttributes=headPose,glasses". Die Gesichtsattributeanalyse hat zusätzliche Rechen- und Zeitkosten.
returnFaceId	query		boolean	Zurückgeben von FaceIds der erkannten Gesichter oder nicht. Der Standardwert ist true.
returnFaceLandmarks	query		boolean	Geben Sie Die Sehenswürdigkeiten der erkannten Gesichter zurück oder nicht. Der Standardwert ist "false".
returnRecognitionModel	query		boolean	Gibt "recognitionModel" zurück oder nicht. Der Standardwert ist "false". Dies gilt nur, wenn returnFaceId = true.

Anforderungstext

Media Types: "application/octet-stream"

Name	Typ	Beschreibung
imageContent	string	Die Binärdatei des Eingabebilds.

Antworten

Name	Typ	Beschreibung
200 OK	FaceDetectionResult[]	Ein erfolgreicher Aufruf gibt ein Array von Gesichtseinträgen zurück, die nach der Größe des Gesichtsrechtecks in absteigender Reihenfolge bewertet wurden. Eine leere Antwort gibt an, dass keine Gesichter erkannt wurden.
Other Status Codes	FaceErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

FaceDetectionResult[]

Ein erfolgreicher Aufruf gibt ein Array von Gesichtseinträgen zurück, die nach der Größe des Gesichtsrechtecks in absteigender Reihenfolge bewertet wurden. Eine leere Antwort gibt an, dass keine Gesichter erkannt wurden.

Other Status Codes

FaceErrorResponse

Unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

Name	Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Detect with Image

Beispielanforderung

HTTP

POST {endpoint}/face/v1.2-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Beispiel für eine Antwort

Statuscode:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Definitionen

Name	Beschreibung
AccessoryItem	Zubehörartikel und entsprechende Konfidenzstufe.
AccessoryType	Typ des Zubehörs.
BlurLevel	Gibt den Grad der Verschwommenheit an.
BlurProperties	Eigenschaften, die das Vorhandensein von Weichzeichnern innerhalb des Bilds beschreiben.
DetectionModel	Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte 'detectionModel'-Werte umfassen "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
ExposureLevel	Gibt den Grad der Belichtung an.
ExposureProperties	Eigenschaften, die die Belichtungsebene des Bilds beschreiben.
FaceAttributes	Gesichtsattribute für das erkannte Gesicht.
FaceAttributeType	Analysieren und zurückgeben Sie die angegebenen Gesichtsattribute in der durch Trennzeichen getrennten Zeichenfolge wie "returnFaceAttributes=headPose,glasses". Die Gesichtsattributeanalyse hat zusätzliche Rechen- und Zeitkosten.
FaceDetectionResult	Antwort für die Erkennungs-API.
FaceError	Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.
FaceLandmarks	Eine Sammlung von 27 Punkt-Gesicht-Sehenswürdigkeiten, die auf die wichtigen Positionen von Gesichtskomponenten zeigen.
FaceRectangle	Ein Rechteck, in dem ein Gesicht gefunden werden kann.
FacialHair	Eigenschaften, die Gesichtshaarattribute beschreiben.
GlassesType	Brille Typ des Gesichtes.
HairColor	Ein Array von Kandidatenfarben und Konfidenzniveau im Vorhandensein der einzelnen.
HairColorType	Name der Haarfarbe.
HairProperties	Eigenschaften, die Haarattribute beschreiben.
HeadPose	3D-Roll/Gierwinkel/Winkel für die Gesichtsrichtung.
LandmarkCoordinate	Orientierungskoordinaten innerhalb eines Bilds.
MaskProperties	Eigenschaften, die das Vorhandensein einer Maske auf einem bestimmten Gesicht beschreiben.
MaskType	Typ der Maske.
NoiseLevel	Gibt den Rauschpegel an.
NoiseProperties	Eigenschaften, die den Rauschpegel des Bilds beschreiben.
OcclusionProperties	Eigenschaften, die Okklusionen für ein bestimmtes Gesicht beschreiben.
QualityForRecognition	Gibt die Qualität des Bilds für die Erkennung an.
RecognitionModel	Das Erkennungsmodell für das Gesicht.

AccessoryItem

Zubehörartikel und entsprechende Konfidenzstufe.

Name	Typ	Beschreibung
confidence	number	Konfidenzniveau des Zubehörtyps. Bereich zwischen [0,1].
type	AccessoryType	Typ des Zubehörs.

AccessoryType

Typ des Zubehörs.

Name	Typ	Beschreibung
glasses	string	Brille.
headwear	string	Kopfverschleiß.
mask	string	Maske.

BlurLevel

Gibt den Grad der Verschwommenheit an.

Name	Typ	Beschreibung
high	string	Hoher Weichzeichner.
low	string	Niedriger Weichzeichner.
medium	string	Mittlere Weichzeichnerebene.

BlurProperties

Eigenschaften, die das Vorhandensein von Weichzeichnern innerhalb des Bilds beschreiben.

Name	Typ	Beschreibung
blurLevel	BlurLevel	Ein Enumerationswert, der die Verschwommenheitsstufe angibt.
value	number	Eine Zahl, die den Grad der Verschwommenheit zwischen 0 und 1 angibt.

DetectionModel

Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte 'detectionModel'-Werte umfassen "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".

Name	Typ	Beschreibung
detection_01	string	Das Standarderkennungsmodell. Empfohlen für die Nah frontale Gesichtserkennung. Bei Szenarien mit außergewöhnlich großen Winkeln (Kopf-Pose), verdeckten Gesichtern oder falscher Bildausrichtung werden die Gesichter in solchen Fällen möglicherweise nicht erkannt.
detection_02	string	Das 2019 veröffentlichte Erkennungsmodell wurde im Mai 2019 mit verbesserter Genauigkeit insbesondere auf kleinen, seitlichen und verschwommenen Gesichtern veröffentlicht.
detection_03	string	Das Im Februar 2021 veröffentlichte Erkennungsmodell mit verbesserter Genauigkeit insbesondere auf kleinen Gesichtern.

ExposureLevel

Gibt den Grad der Belichtung an.

Name	Typ	Beschreibung
goodExposure	string	Gute Belichtungsstufe.
overExposure	string	Hohe Expositionsstufe.
underExposure	string	Niedrige Expositionsstufe.

ExposureProperties

Eigenschaften, die die Belichtungsebene des Bilds beschreiben.

Name	Typ	Beschreibung
exposureLevel	ExposureLevel	Ein Enumerationswert, der den Expositionsgrad angibt.
value	number	Eine Zahl, die den Expositionsgrad von 0 bis 1 angibt. [0, 0,25) ist unter Exposition. [0,25, 0,75) ist eine gute Exposition. [0,75, 1] ist über die Exposition.

FaceAttributes

Gesichtsattribute für das erkannte Gesicht.

Name	Typ	Beschreibung
accessories	AccessoryItem[]	Eigenschaften, die jedes Zubehör auf einem bestimmten Gesicht beschreiben.
age	number	Alter in Jahren.
blur	BlurProperties	Eigenschaften, die das Vorhandensein von Weichzeichnern innerhalb des Bilds beschreiben.
exposure	ExposureProperties	Eigenschaften, die die Belichtungsebene des Bilds beschreiben.
facialHair	FacialHair	Eigenschaften, die Gesichtshaarattribute beschreiben.
glasses	GlassesType	Brille geben ein, wenn eines der Gesichte.
hair	HairProperties	Eigenschaften, die Haarattribute beschreiben.
headPose	HeadPose	3D-Roll/Gierwinkel/Winkel für die Gesichtsrichtung.
mask	MaskProperties	Eigenschaften, die das Vorhandensein einer Maske auf einem bestimmten Gesicht beschreiben.
noise	NoiseProperties	Eigenschaften, die den Rauschpegel des Bilds beschreiben.
occlusion	OcclusionProperties	Eigenschaften, die Okklusionen für ein bestimmtes Gesicht beschreiben.
qualityForRecognition	QualityForRecognition	Eigenschaften, die die allgemeine Bildqualität beschreiben, ob das in der Erkennung verwendete Bild von ausreichender Qualität ist, um die Gesichtserkennung zu versuchen.
smile	number	Lächeln intensität, eine Zahl zwischen [0,1].

FaceAttributeType

Analysieren und zurückgeben Sie die angegebenen Gesichtsattribute in der durch Trennzeichen getrennten Zeichenfolge wie "returnFaceAttributes=headPose,glasses". Die Gesichtsattributeanalyse hat zusätzliche Rechen- und Zeitkosten.

Name	Typ	Beschreibung
accessories	string	Accessoires rund ums Gesicht, einschließlich "Kopfbekleidung", "Brille" und "Maske". Leeres Array bedeutet, dass kein Zubehör erkannt wurde. Beachten Sie, dass ein Gesicht erkannt wurde. Große Maske könnte dazu führen, dass kein Gesicht erkannt wird.
age	string	Alter in Jahren.
blur	string	Das Gesicht ist verschwommen oder nicht. Der Level gibt "Niedrig", "Mittel" oder "Hoch" zurück. Der Wert gibt eine Zahl zwischen [0,1] zurück, desto größer ist die Verschwommene.
exposure	string	Gesichtsbelichtungsstufe. Level gibt "GoodExposure", "OverExposure" oder "UnderExposure" zurück.
facialHair	string	Eigenschaften, die Gesichtshaarattribute beschreiben.
glasses	string	Brille Typ. Die Werte umfassen 'NoGlasses', 'ReadingGlasses', 'Sonnenbrillen', 'SwimmingGoggles'.
hair	string	Eigenschaften, die Haarattribute beschreiben.
headPose	string	3D-Roll/Gierwinkel/Winkel für die Gesichtsrichtung.
mask	string	Ob jedes Gesicht eine Maske trägt. Der Maskentyp gibt "noMask", "faceMask", "otherMaskOrOcclusion" oder "unsicher" zurück. Der Wert gibt einen booleschen "noseAndMouthCovered" zurück, der angibt, ob Nase und Mund bedeckt sind.
noise	string	Rauschpegel der Gesichtspixel. Der Level gibt "Niedrig", "Mittel" und "Hoch" zurück. Der Wert gibt eine Zahl zwischen [0,1] zurück, desto größer ist der Noisierer.
occlusion	string	Ob jeder Gesichtsbereich verdeckt ist, einschließlich Stirn, Augen und Mund.
qualityForRecognition	string	Die gesamtbildliche Qualität, ob das in der Erkennung verwendete Bild von ausreichender Qualität ist, um die Gesichtserkennung zu versuchen. Der Wert ist eine informelle Bewertung von niedrig, mittel oder hoch. Nur "hochwertige" Bilder werden für die Registrierung und Qualität von Personen bei oder über "medium" empfohlen, wird für Identifikationsszenarien empfohlen. Das Attribut ist nur verfügbar, wenn Erkennungsmodelle recognition_03 oder recognition_04 verwendet werden.
smile	string	Lächeln intensität, eine Zahl zwischen [0,1].

FaceDetectionResult

Antwort für die Erkennungs-API.

Name	Typ	Beschreibung
faceAttributes	FaceAttributes	Gesichtsattribute für erkanntes Gesicht.
faceId	string	Eindeutige FaceId des erkannten Gesichts, erstellt von der Erkennungs-API und läuft 24 Stunden nach dem Erkennungsaufruf ab. Um dies zurückzugeben, muss der Parameter "returnFaceId" "true" sein.
faceLandmarks	FaceLandmarks	Ein Array von 27 Punkt bezogenen Sehenswürdigkeiten, die auf die wichtigen Positionen von Gesichtskomponenten zeigen. Um dies zurückzugeben, muss der Parameter "returnFaceLandmarks" wahr sein.
faceRectangle	FaceRectangle	Ein Rechteckbereich für die Gesichtsposition auf dem Bild.
recognitionModel	RecognitionModel	Das "recognitionModel", das dieser faceId zugeordnet ist. Dies wird nur zurückgegeben, wenn "returnRecognitionModel" explizit als "true" festgelegt wird.

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
message	string	Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

FaceLandmarks

Eine Sammlung von 27 Punkt-Gesicht-Sehenswürdigkeiten, die auf die wichtigen Positionen von Gesichtskomponenten zeigen.

Name	Typ	Beschreibung
eyeLeftBottom	LandmarkCoordinate	Die Koordinaten des linken Auges unten.
eyeLeftInner	LandmarkCoordinate	Die Koordinaten des linken Auges innen.
eyeLeftOuter	LandmarkCoordinate	Die Koordinaten des linken Auges außen.
eyeLeftTop	LandmarkCoordinate	Die Koordinaten des linken Auges oben.
eyeRightBottom	LandmarkCoordinate	Die Koordinaten des rechten Auges unten.
eyeRightInner	LandmarkCoordinate	Die Koordinaten des rechten Auges innen.
eyeRightOuter	LandmarkCoordinate	Die Koordinaten des rechten Auges außen.
eyeRightTop	LandmarkCoordinate	Die Koordinaten des rechten Auges oben.
eyebrowLeftInner	LandmarkCoordinate	Die Koordinaten der linken Augenbrauen innen.
eyebrowLeftOuter	LandmarkCoordinate	Die Koordinaten der linken Augenbrauen außen.
eyebrowRightInner	LandmarkCoordinate	Die Koordinaten der rechten Augenbrauen innen.
eyebrowRightOuter	LandmarkCoordinate	Die Koordinaten der rechten Augenbrauen außen.
mouthLeft	LandmarkCoordinate	Die Koordinaten des Mundes links.
mouthRight	LandmarkCoordinate	Die Koordinaten des Mundes rechts.
noseLeftAlarOutTip	LandmarkCoordinate	Die Koordinaten der Nase haben eine lare Spitze verlassen.
noseLeftAlarTop	LandmarkCoordinate	Die Koordinaten der Nase links oben.
noseRightAlarOutTip	LandmarkCoordinate	Die Koordinaten der Nase rechts alar out tip.
noseRightAlarTop	LandmarkCoordinate	Die Koordinaten der Nase rechts oben.
noseRootLeft	LandmarkCoordinate	Die Koordinaten der Nasenwurzel links.
noseRootRight	LandmarkCoordinate	Die Koordinaten der Nasenwurzel rechts.
noseTip	LandmarkCoordinate	Die Koordinaten der Nasenspitze.
pupilLeft	LandmarkCoordinate	Die Koordinaten des linken Auge-Schülers.
pupilRight	LandmarkCoordinate	Die Koordinaten des rechten Augen-Schülers.
underLipBottom	LandmarkCoordinate	Die Koordinaten der untere Lippe unten.
underLipTop	LandmarkCoordinate	Die Koordinaten der Unterlippe oben.
upperLipBottom	LandmarkCoordinate	Die Koordinaten des oberen Lippenbodens.
upperLipTop	LandmarkCoordinate	Die Koordinaten der oberen Lippe.

FaceRectangle

Ein Rechteck, in dem ein Gesicht gefunden werden kann.

Name	Typ	Beschreibung
height	integer	Die Höhe des Rechtecks in Pixel.
left	integer	Der Abstand vom linken Rand, wenn das Bild zum linken Rand des Rechtecks in Pixeln angezeigt wird.
top	integer	Der Abstand vom oberen Rand, wenn das Bild zum oberen Rand des Rechtecks in Pixeln liegt.
width	integer	Die Breite des Rechtecks in Pixel.

FacialHair

Eigenschaften, die Gesichtshaarattribute beschreiben.

Name	Typ	Beschreibung
beard	number	Eine Zahl zwischen 0 und 1, die ein Konfidenzniveau angibt, das einer Eigenschaft zugeordnet ist.
moustache	number	Eine Zahl zwischen 0 und 1, die ein Konfidenzniveau angibt, das einer Eigenschaft zugeordnet ist.
sideburns	number	Eine Zahl zwischen 0 und 1, die ein Konfidenzniveau angibt, das einer Eigenschaft zugeordnet ist.

GlassesType

Brille Typ des Gesichtes.

Name	Typ	Beschreibung
noGlasses	string	Keine Brille auf dem Gesicht.
readingGlasses	string	Normale Brille auf dem Gesicht.
sunglasses	string	Sonnenbrille auf dem Gesicht.
swimmingGoggles	string	Schwimmen Brille auf dem Gesicht.

HairColor

Ein Array von Kandidatenfarben und Konfidenzniveau im Vorhandensein der einzelnen.

Name	Typ	Beschreibung
color	HairColorType	Name der Haarfarbe.
confidence	number	Konfidenzniveau der Farbe. Bereich zwischen [0,1].

HairColorType

Name der Haarfarbe.

Name	Typ	Beschreibung
black	string	Schwarz.
blond	string	Blond.
brown	string	Braun.
gray	string	Grau.
other	string	Andere.
red	string	Rot.
unknown	string	Unbekannt.
white	string	Weiß.

HairProperties

Eigenschaften, die Haarattribute beschreiben.

Name	Typ	Beschreibung
bald	number	Eine Zahl, die das Konfidenzniveau beschreibt, ob die Person bald ist.
hairColor	HairColor[]	Ein Array von Kandidatenfarben und Konfidenzniveau im Vorhandensein der einzelnen.
invisible	boolean	Ein boolescher Wert, der beschreibt, ob das Haar im Bild sichtbar ist.

HeadPose

3D-Roll/Gierwinkel/Winkel für die Gesichtsrichtung.

Name	Typ	Beschreibung
pitch	number	Wert von Winkeln.
roll	number	Wert von Winkeln.
yaw	number	Wert von Winkeln.

LandmarkCoordinate

Orientierungskoordinaten innerhalb eines Bilds.

Name	Typ	Beschreibung
x	number	Die horizontale Komponente in Pixel.
y	number	Die vertikale Komponente in Pixel.

MaskProperties

Eigenschaften, die das Vorhandensein einer Maske auf einem bestimmten Gesicht beschreiben.

Name	Typ	Beschreibung
noseAndMouthCovered	boolean	Ein boolescher Wert, der angibt, ob Nase und Mund bedeckt sind.
type	MaskType	Typ der Maske.

MaskType

Typ der Maske.

Name	Typ	Beschreibung
faceMask	string	Gesichtsmaske.
noMask	string	Keine Maske.
otherMaskOrOcclusion	string	Andere Arten von Masken oder Okklusion.
uncertain	string	Unsicher.

NoiseLevel

Gibt den Rauschpegel an.

Name	Typ	Beschreibung
high	string	Hoher Lärmpegel.
low	string	Geringer Rauschpegel.
medium	string	Mittlerer Rauschpegel.

NoiseProperties

Eigenschaften, die den Rauschpegel des Bilds beschreiben.

Name	Typ	Beschreibung
noiseLevel	NoiseLevel	Ein Enumerationswert, der den Rauschpegel angibt.
value	number	Eine Zahl, die den Rauschpegel zwischen 0 und 1 angibt. [0, 0,25) ist unter Exposition. [0,25, 0,75) ist eine gute Exposition. [0,75, 1] ist über die Exposition. [0, 0,3) ist ein niedriger Rauschpegel. [0.3, 0,7) ist mittlerer Rauschpegel. [0,7, 1] ist ein hoher Geräuschpegel.

OcclusionProperties

Eigenschaften, die Okklusionen für ein bestimmtes Gesicht beschreiben.

Name	Typ	Beschreibung
eyeOccluded	boolean	Ein boolescher Wert, der angibt, ob Augen verdeckt sind.
foreheadOccluded	boolean	Ein boolescher Wert, der angibt, ob der Stirn verdeckt ist.
mouthOccluded	boolean	Ein boolescher Wert, der angibt, ob der Mund verdeckt ist.

QualityForRecognition

Gibt die Qualität des Bilds für die Erkennung an.

Name	Typ	Beschreibung
high	string	Hochwertige.
low	string	Niedrige Qualität.
medium	string	Mittlere Qualität.

RecognitionModel

Das Erkennungsmodell für das Gesicht.

Name	Typ	Beschreibung
recognition_01	string	Das Standarderkennungsmodell für "Erkennen". Alle faceIds, die vor dem März 2019 erstellt wurden, sind mit diesem Erkennungsmodell verbunden.
recognition_02	string	Erkennungsmodell, das im März 2019 veröffentlicht wurde.
recognition_03	string	Erkennungsmodell, das im Mai 2020 veröffentlicht wurde.
recognition_04	string	Erkennungsmodell, das im Februar 2021 veröffentlicht wurde. Es wird empfohlen, dieses Erkennungsmodell für eine bessere Erkennungsgenauigkeit zu verwenden.

Freigeben über

Face Detection Operations - Detect

URI-Parameter

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

AADToken

Bereiche

Beispiele

Detect with Image

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel

Zusätzliche Ressourcen