Face Detection Operations - Detect

Referenz

Dienst:: Azure AI Services

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

Hiermit werden menschliche Gesichter in einem Bild erkannt und Rechtecke für die Gesichter sowie optional faceIds, Sehenswürdigkeiten und Attribute zurückgegeben.

Wichtig

Um potenziellen Missbrauch zu mindern, der Menschen Stereotypisierung, Diskriminierung oder unfaire Verweigerung von Diensten aussetzen kann, setzen wir Gesichts-API-Attribute aus, die Emotionen, Geschlecht, Alter, Lächeln, Gesichtshaare, Haare und Make-Up vorhersagen. Weitere Informationen zu dieser Entscheidung https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/finden Sie hier.

- Es wird kein Bild gespeichert. Nur die extrahierten Gesichtserkennungsfeatures werden auf dem Server gespeichert. Die faceId ist ein Bezeichner des Gesichtsfeatures und wird in "Identifizieren", "Überprüfen" und "Ähnlich suchen" verwendet. Die gespeicherten Gesichtserkennungsfeatures laufen ab und werden zu dem von faceIdTimeToLive nach dem ursprünglichen Erkennungsaufruf angegebenen Zeitpunkt gelöscht.
- Optionale Parameter sind faceId, Landmarken und Attribute. Zu den Attributen gehören headPose, Brillen, Okklusion, Zubehör, Weichzeichner, Belichtung, Rauschen, Maske und QualityForRecognition. Einige der für bestimmte Attribute zurückgegebenen Ergebnisse sind möglicherweise nicht sehr genau.
- JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße liegt zwischen 1 KB und 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 einer Größe von mehr als 1920 x 1080 Pixel benötigen eine proportional größere Mindestgröße.
- Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden dabei nach der Rechteckgröße der Gesichter von groß nach klein bewertet.
- Um optimale Ergebnisse bei Abfragen von "Identify", "Verify" und "Find Similar" ('returnFaceId' is true) zu erhalten, verwenden Sie gesichter: frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen).
- Es können verschiedene "detectionModel"-Werte angegeben 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 Orientierungspunkte sind deaktiviert, wenn Sie dieses Erkennungsmodell auswählen.
  - 'detection_03': Gesichtsattribute (mask, weichzeichnen und headPose) und Orientierungspunkte werden unterstützt, wenn Sie dieses Erkennungsmodell auswählen.
- Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Folgevorgä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". Wenn das neueste Modell erforderlich ist, geben Sie in diesem Parameter explizit das modell an, das Sie benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Informationen 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 sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
faceIdTimeToLive	query		integer int32	Die Anzahl der Sekunden für die zwischengespeicherte Gesichts-ID. Unterstützter Bereich von 60 Sekunden bis zu 86400 Sekunden. Der Standardwert beträgt 86400 Sekunden (24 Stunden).
recognitionModel	query		RecognitionModel	Das "recognitionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "recognitionModel"-Werte sind "recognition_01", "recognition_02", "recognition_03" oder "recognition_04". Der Standardwert ist "recognition_01". "recognition_04" wird empfohlen, da seine 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, z. B. "returnFaceAttributes=headPose,glasses". Die Gesichtserkennungsattributanalyse hat zusätzliche Rechen- und Zeitkosten.
returnFaceId	query		boolean	Gibt faceIds der erkannten Gesichter zurück oder nicht. Der Standardwert lautet „true“.
returnFaceLandmarks	query		boolean	Zurück zur Gesichtserkennung der erkannten Gesichter 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 ist.

Anforderungstext

Media Types: "application/octet-stream"

Name	Typ	Beschreibung
imageContent	string	Die Eingabebild-Binärdatei.

Antworten

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

Name

Typ

Beschreibung

200 OK

FaceDetectionResult[]

Bei einem erfolgreichen Aufruf wird ein Array von Gesichtseinträgen zurückgegeben, die nach der Größe des Gesichtsrechtecks in absteigender Reihenfolge sortiert sind. Eine leere Antwort gibt an, dass keine Gesichter erkannt wurden.

Other Status Codes

FaceErrorResponse

Eine 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-Flow

Typ: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Beispiele

Detect with Image

Sample request

HTTP

POST {endpoint}/face/v1.1-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>"

Sample response

Status code:: 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örelement und entsprechendes Konfidenzniveau.
AccessoryType	Typ des Zubehörs.
BlurLevel	Gibt den Grad der Unschärfe an.
BlurProperties	Eigenschaften, die das Vorhandensein von Unschärfe im Bild beschreiben.
DetectionModel	Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "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, z. B. "returnFaceAttributes=headPose,glasses". Die Gesichtserkennungsattributanalyse 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 Gesichtserkennungsdienst 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-Gesichtspunkten, die auf die wichtigen Positionen von Gesichtskomponenten zeigen.
FaceRectangle	Ein Rechteck, in dem ein Gesicht gefunden werden kann.
FacialHair	Eigenschaften, die Gesichtshaarattribute beschreiben.
GlassesType	Brillentyp des Gesichts.
HairColor	Ein Array von Kandidatenfarben und Konfidenzstufen in Anwesenheit jeder einzelnen.
HairColorType	Name der Haarfarbe.
HairProperties	Eigenschaften, die Haarattribute beschreiben.
HeadPose	3D-Roll/Yaw/Pitch-Winkel für die Gesichtsrichtung.
LandmarkCoordinate	Richtungskoordinaten innerhalb eines Bilds.
MaskProperties	Eigenschaften, die das Vorhandensein einer Maske auf einem bestimmten Gesicht beschreiben.
MaskType	Typ der Maske.
NoiseLevel	Gibt den Geräuschpegel an.
NoiseProperties	Eigenschaften, die den Rauschpegel des Bilds beschreiben.
OcclusionProperties	Eigenschaften, die Verschlüsse 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örelement und entsprechendes Konfidenzniveau.

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

AccessoryType

Typ des Zubehörs.

Name	Typ	Beschreibung
glasses	string	Gläser.
headwear	string	Kopfverschleiß.
mask	string	Maske.

BlurLevel

Gibt den Grad der Unschärfe an.

Name	Typ	Beschreibung
high	string	Hohe Unschärfe.
low	string	Niedrige Unschärfe.
medium	string	Mittlere Unschärfeebene.

BlurProperties

Eigenschaften, die das Vorhandensein von Unschärfe im Bild beschreiben.

Name	Typ	Beschreibung
blurLevel	BlurLevel	Ein Enumerationswert, der den Grad der Unschärfe angibt.
value	number	Eine Zahl, die den Grad der Unschärfe von 0 bis 1 angibt.

DetectionModel

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

Name	Typ	Beschreibung
detection_01	string	Das Standarderkennungsmodell. Empfohlen für die Naherkennung des Frontalgesichts. In Szenarien mit außergewöhnlich großem Winkel (Kopfhaltung), verdeckten Gesichtern oder falscher Bildausrichtung werden die Gesichter in solchen Fällen möglicherweise nicht erkannt.
detection_02	string	Erkennungsmodell im Mai 2019 mit verbesserter Genauigkeit, insbesondere auf kleinen, seiten- und verschwommenen Gesichtern.
detection_03	string	Das im Februar 2021 veröffentlichte Erkennungsmodell mit verbesserter Genauigkeit, insbesondere bei kleinen Gesichtern.

ExposureLevel

Gibt den Grad der Belichtung an.

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

ExposureProperties

Eigenschaften, die die Belichtungsebene des Bilds beschreiben.

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

FaceAttributes

Gesichtsattribute für das erkannte Gesicht.

Name	Typ	Beschreibung
accessories	AccessoryItem[]	Eigenschaften, die alle Zubehörteile auf einem bestimmten Gesicht beschreiben.
age	number	Alter in Jahren.
blur	BlurProperties	Eigenschaften, die das Vorhandensein von Weichzeichnern im Bild beschreiben.
exposure	ExposureProperties	Eigenschaften, die die Belichtungsebene des Bilds beschreiben.
facialHair	FacialHair	Eigenschaften, die Gesichtshaarattribute beschreiben.
glasses	GlassesType	Die Brille gibt an, ob eine der Gesichter vorhanden ist.
hair	HairProperties	Eigenschaften, die Haarattribute beschreiben.
headPose	HeadPose	3D-Roll-, Gähn-/Neigungswinkel 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 Verdeckungen auf einem bestimmten Gesicht beschreiben.
qualityForRecognition	QualityForRecognition	Eigenschaften, die die Gesamtbildqualität beschreiben, ob das bild, das bei der Erkennung verwendet wird, von ausreichender Qualität ist, um die Gesichtserkennung zu versuchen.
smile	number	Intensität des Lächelns, eine Zahl zwischen [0,1].

FaceAttributeType

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

Name	Typ	Beschreibung
accessories	string	Accessoires rund um das Gesicht, einschließlich "Kopfbedeckung", "Brille" und "Maske". Leeres Array bedeutet, dass kein Zubehör erkannt wurde. Beachten Sie, dass dies geschieht, nachdem ein Gesicht erkannt wurde. Eine 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. Level gibt "Low", "Medium" oder "High" zurück. Value gibt eine Zahl zwischen [0,1] zurück, je größer die Verschwommene.
exposure	string	Gesichtsbelichtungsstufe. Level gibt "GoodExposure", "OverExposure" oder "UnderExposure" zurück.
facialHair	string	Eigenschaften, die Gesichtshaarattribute beschreiben.
glasses	string	Brillentyp. Zu den Werten gehören "NoGlasses", "ReadingGlasses", "Sunglasses", "SwimmingGoggles".
hair	string	Eigenschaften, die Haarattribute beschreiben.
headPose	string	3D-Roll-, Gähn-/Neigungswinkel für die Gesichtsrichtung.
mask	string	Ob jedes Gesicht eine Maske trägt. Der Maskentyp gibt "noMask", "faceMask", "otherMaskOrOcclusion" oder "unsicher" zurück. Value gibt einen booleschen "noseAndMouthCovered" zurück, der angibt, ob Nase und Mund bedeckt sind.
noise	string	Rauschpegel von Gesichtspixeln. Level gibt "Low", "Medium" und "High" zurück. Der Wert gibt eine Zahl zwischen [0,1] zurück, je größer der Lauter ist.
occlusion	string	Gibt an, ob jeder Gesichtsbereich verdeckt ist, einschließlich Stirn, Augen und Mund.
qualityForRecognition	string	Die Gesamtbildqualität hinsichtlich der Frage, ob das bild, das bei der Erkennung verwendet wird, von ausreichender Qualität ist, um die Gesichtserkennung zu versuchen. Der Wert ist eine informelle Bewertung von niedrig, mittel oder hoch. Für die Personenregistrierung werden nur Bilder mit hoher Qualität empfohlen, und für Identifikationsszenarien wird eine Qualität mit oder über "mittel" empfohlen. Das Attribut ist nur verfügbar, wenn Erkennungsmodelle recognition_03 oder recognition_04 verwendet werden.
smile	string	Intensität des Lächelns, 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 mit 27 Punkten zu Gesichtszügen, die auf die wichtigen Positionen von Gesichtskomponenten hinweisen Um dies zurückzugeben, muss der Parameter "returnFaceLandmarks" true 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 auf true festgelegt ist.

FaceError

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

Name	Typ	Beschreibung
code	string	Einer der vom Server definierten Fehlercodes.
message	string	Eine für Menschen lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

FaceLandmarks

Eine Sammlung von 27-Punkt-Gesichtspunkten, die auf die wichtigen Positionen von Gesichtskomponenten zeigen.

Name	Typ	Beschreibung
eyeLeftBottom	LandmarkCoordinate	Die Koordinaten des linken Unteren Auges.
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 unteren rechten Auges.
eyeRightInner	LandmarkCoordinate	Die Koordinaten des inneren rechten Auges.
eyeRightOuter	LandmarkCoordinate	Die Koordinaten des äußeren rechten Auges.
eyeRightTop	LandmarkCoordinate	Die Koordinaten des oberen rechten Auges.
eyebrowLeftInner	LandmarkCoordinate	Die Koordinaten der linken Augenbraue innen.
eyebrowLeftOuter	LandmarkCoordinate	Die Koordinaten der linken Augenbrauen außen.
eyebrowRightInner	LandmarkCoordinate	Die Koordinaten der rechten Augenbraue innen.
eyebrowRightOuter	LandmarkCoordinate	Die Koordinaten der äußeren rechten Augenbrauen.
mouthLeft	LandmarkCoordinate	Die Koordinaten des Mundes links.
mouthRight	LandmarkCoordinate	Die Koordinaten des Mundes rechts.
noseLeftAlarOutTip	LandmarkCoordinate	Die Koordinaten der Nase ließen eine größere Spitze übrig.
noseLeftAlarTop	LandmarkCoordinate	Die Koordinaten der Nase links alar oben.
noseRightAlarOutTip	LandmarkCoordinate	Die Koordinaten der Nase rechts alar out Tip.
noseRightAlarTop	LandmarkCoordinate	Die Koordinaten der Nase rechts alar 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 der Pupillen des linken Auges.
pupilRight	LandmarkCoordinate	Die Koordinaten der Rechten Augen-Pupillen.
underLipBottom	LandmarkCoordinate	Die Koordinaten des unteren Lippenbodens.
underLipTop	LandmarkCoordinate	Die Koordinaten der unteren Lippenoberseite.
upperLipBottom	LandmarkCoordinate	Die Koordinaten des Oberlippenbodens.
upperLipTop	LandmarkCoordinate	Die Koordinaten der Oberlippenoberseite.

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 angezeigt wird.
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 eine Miteigenschaft zugeordnete Konfidenz angibt.
moustache	number	Eine Zahl zwischen 0 und 1, die eine Miteigenschaft zugeordnete Konfidenz angibt.
sideburns	number	Eine Zahl zwischen 0 und 1, die eine Miteigenschaft zugeordnete Konfidenz angibt.

GlassesType

Brillentyp des Gesichts.

Name	Typ	Beschreibung
noGlasses	string	Keine Brille im Gesicht.
readingGlasses	string	Normale Gläser auf dem Gesicht.
sunglasses	string	Sonnenbrille im Gesicht.
swimmingGoggles	string	Schwimmbrille im Gesicht.

HairColor

Ein Array von Kandidatenfarben und Konfidenzstufen in Anwesenheit jeder 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	Sonstiges
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 glatzen ist.
hairColor	HairColor[]	Ein Array von Kandidatenfarben und Konfidenzstufen in Anwesenheit jeder einzelnen.
invisible	boolean	Ein boolescher Wert, der beschreibt, ob das Haar im Bild sichtbar ist.

HeadPose

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

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

LandmarkCoordinate

Richtungskoordinaten 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 Masken- oder Verdeckungstypen.
uncertain	string	Unsicher.

NoiseLevel

Gibt den Geräuschpegel an.

Name	Typ	Beschreibung
high	string	Hoher Geräuschpegel.
low	string	Niedriger Geräuschpegel.
medium	string	Mittlerer Geräuschpegel.

NoiseProperties

Eigenschaften, die den Rauschpegel des Bilds beschreiben.

Name	Typ	Beschreibung
noiseLevel	NoiseLevel	Ein Enumerationswert, der den Geräuschpegel angibt.
value	number	Eine Zahl, die den Geräuschpegel von 0 bis 1 angibt. [0, 0,25) ist ausgesetzt. [0,25, 0,75) ist eine gute Belichtung. [0,75, 1] ist überbelichtt. [0, 0.3) ist ein niedriger Geräuschpegel. [0.3, 0.7) ist mittlerer Geräuschpegel. [0.7, 1] ist ein hoher Geräuschpegel.

OcclusionProperties

Eigenschaften, die Verschlüsse für ein bestimmtes Gesicht beschreiben.

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

QualityForRecognition

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

Name	Typ	Beschreibung
high	string	Hohe Qualität.
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 "Detect". Alle faceIds, die vor März 2019 erstellt wurden, sind mit diesem Erkennungsmodell verbunden.
recognition_02	string	Das Erkennungsmodell wurde im März 2019 veröffentlicht.
recognition_03	string	Das Erkennungsmodell wurde im Mai 2020 veröffentlicht.
recognition_04	string	Das Erkennungsmodell wurde im Februar 2021 veröffentlicht. Es wird empfohlen, dieses Erkennungsmodell zu verwenden, um die Erkennungsgenauigkeit zu verbessern.

Freigeben über

Face Detection Operations - Detect

URI-Parameter

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

AADToken

Scopes

Beispiele

Detect with Image

Sample request

Sample response

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