Face Detection Operations - Detect

Service:: Azure AI Services

API-versie:: v1.2

Detecteer menselijke gezichten in een afbeelding, retourneer gezichtsrechthoeken en eventueel met faceIds, oriëntatiepunten en kenmerken.

Belangrijk

Microsoft heeft mogelijkheden voor gezichtsherkenning buiten gebruik gesteld of beperkt, die kunnen worden gebruikt om emotionele toestanden en identiteitskenmerken af te stellen die, indien misbruikt, personen kunnen onderwerpen aan stereotypische, discriminatie of oneerlijke ontkenning van services. De buiten gebruik gestelde mogelijkheden zijn emotie en geslacht. De beperkte mogelijkheden zijn leeftijd, glimlach, gezichtshaar, haar en make-up. E-mail Azure Face-API als u een verantwoorde use case hebt die zou profiteren van het gebruik van een van de beperkte mogelijkheden. Lees hier meer over deze beslissing .

- Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfuncties worden opgeslagen op de server. De faceId is een id van de gezichtsfunctie en wordt gebruikt in 'Identificeren', 'Verifiëren' en 'Vergelijkbare zoeken'. De opgeslagen gezichtsfuncties verlopen en worden verwijderd op het moment dat is opgegeven door faceIdTimeToLive na de oorspronkelijke detectieaanroep.
- Optionele parameters omvatten faceId, oriëntatiepunten en kenmerken. Kenmerken zijn onder andere headPose, bril, occlusie, accessoires, vervagen, blootstelling, ruis, masker en kwaliteitForRecognition. Sommige resultaten die worden geretourneerd voor specifieke kenmerken, zijn mogelijk niet zeer nauwkeurig.
- JPEG-, PNG-, GIF-, GIF-indeling (het eerste frame) en BMP-indeling worden ondersteund. De toegestane grootte van het afbeeldingsbestand is van 1 KB tot 6 MB.
- De minimale detecteerbare gezichtsgrootte is 36x36 pixels in een afbeelding die niet groter is dan 1920x1080 pixels. Afbeeldingen met afmetingen die hoger zijn dan 1920x1080 pixels hebben een proportioneel grotere minimale gezichtsgrootte nodig.
- Er kunnen maximaal 100 gezichten worden geretourneerd voor een afbeelding. Gezichten worden gerangschikt op gezichtsrechthoekgrootte van groot naar klein.
- Voor optimale resultaten bij het opvragen van 'Identificeren', 'Verifiëren' en 'Zoeken vergelijkbaar' ('returnFaceId' is waar), gebruikt u gezichten die zijn: frontaal, helder en met een minimale grootte van 200x200 pixels (100 pixels tussen ogen).
- Er kunnen verschillende 'detectionModel'-waarden worden opgegeven. De beschikbaarheid van oriëntatiepunten en ondersteunde kenmerken is afhankelijk van het opgegeven detectiemodel. Als u verschillende detectiemodellen wilt gebruiken en vergelijken, raadpleegt u hier.
- Er worden verschillende 'recognitionModel'-waarden opgegeven. Als opvolgingsbewerkingen zoals 'Verifiëren', 'Identificeren', 'Zoeken vergelijkbaar' nodig zijn, geeft u het herkenningsmodel op met de parameter recognitionModel. De standaardwaarde voor recognitionModel is 'recognition_01' als het meest recente model nodig is, geeft u expliciet het model op dat u nodig hebt in deze parameter. Zodra dit is opgegeven, worden de gedetecteerde faceIds gekoppeld aan het opgegeven herkenningsmodel. Zie hiervoor meer informatie.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string (uri)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'. 'detection_03' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op kleinere gezichten (64x64 pixels) en gedraaide gezichtsstanden.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Het aantal seconden voor de face-id die in de cache wordt opgeslagen. Ondersteund bereik van 60 seconden tot 86400 seconden. De standaardwaarde is 86400 (24 uur).
recognitionModel	query		RecognitionModel	Het 'recognitionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'recognitionModel'-waarden zijn onder andere 'recognition_01', 'recognition_02', 'recognition_03' of 'recognition_04'. De standaardwaarde is 'recognition_01'. 'recognition_04' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op gezichten die maskers dragen in vergelijking met 'recognition_03', en de algehele nauwkeurigheid ervan wordt verbeterd in vergelijking met 'recognition_01' en 'recognition_02'.
returnFaceAttributes	query		FaceAttributeType[]	Analyseer en retourneer een of meer opgegeven gezichtskenmerken in de door komma's gescheiden tekenreeks zoals 'returnFaceAttributes=headPose,bril'. Analyse van gezichtskenmerken heeft extra rekenkundige en tijdskosten.
returnFaceId	query		boolean	Retourneert faceIds van de gedetecteerde gezichten of niet. De standaardwaarde is waar.
returnFaceLandmarks	query		boolean	Gezichtsoriëntatiepunten van de gedetecteerde gezichten retourneren of niet. De standaardwaarde is onwaar.
returnRecognitionModel	query		boolean	Retourneer 'recognitionModel' of niet. De standaardwaarde is onwaar. Dit is alleen van toepassing wanneer returnFaceId = true.

Aanvraagbody

Media Types: "application/octet-stream"

Name	Type	Description
imageContent	string (binary)	Het binaire bestand van de invoerafbeelding.

Antwoorden

Name	Type	Description
200 OK	FaceDetectionResult[]	Een geslaagde aanroep retourneert een matrix van gezichtsvermeldingen gerangschikt op de grootte van de gezichtsrechthoek in aflopende volgorde. Een leeg antwoord geeft aan dat er geen gezichten zijn gedetecteerd.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Name

Type

Description

200 OK

FaceDetectionResult[]

Een geslaagde aanroep retourneert een matrix van gezichtsvermeldingen gerangschikt op de grootte van de gezichtsrechthoek in aflopende volgorde. Een leeg antwoord geeft aan dat er geen gezichten zijn gedetecteerd.

Other Status Codes

FaceErrorResponse

Een onverwachte foutreactie.

Kopteksten

x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Detect with Image

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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"
    }
  }
]

Definities

Name	Description
AccessoryItem	Accessoire-item en bijbehorend betrouwbaarheidsniveau.
AccessoryType	Type van het accessoire.
BlurLevel	Geeft het niveau van wazigheid aan.
BlurProperties	Eigenschappen die de aanwezigheid van vervaging binnen de afbeelding beschrijven.
DetectionModel	Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'. 'detection_03' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op kleinere gezichten (64x64 pixels) en gedraaide gezichtsstanden.
ExposureLevel	Geeft het niveau van blootstelling aan.
ExposureProperties	Eigenschappen die het belichtingsniveau van de afbeelding beschrijven.
FaceAttributes	Gezichtskenmerken voor het gedetecteerde gezicht.
FaceAttributeType	Analyseer en retourneer een of meer opgegeven gezichtskenmerken in de door komma's gescheiden tekenreeks zoals 'returnFaceAttributes=headPose,bril'. Analyse van gezichtskenmerken heeft extra rekenkundige en tijdskosten.
FaceDetectionResult	Antwoord voor detectie-API.
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
FaceLandmarks	Een verzameling van 27 gezichtsoriëntatiepunten die verwijzen naar de belangrijke posities van gezichtsonderdelen.
FaceRectangle	Een rechthoek waarin een gezicht kan worden gevonden.
FacialHair	Eigenschappen die gezichtshaarkenmerken beschrijven.
GlassesType	Briltype van het gezicht.
HairColor	Een matrix van kandidaatkleuren en betrouwbaarheidsniveau in aanwezigheid van elk.
HairColorType	Naam van de haarkleur.
HairProperties	Eigenschappen die haarkenmerken beschrijven.
HeadPose	3D-rol-/yaw-/pitchhoeken voor gezichtsrichting.
LandmarkCoordinate	Oriëntatiepuntcoördinaten binnen een afbeelding.
MaskProperties	Eigenschappen die de aanwezigheid van een masker op een bepaald gezicht beschrijven.
MaskType	Type masker.
NoiseLevel	Geeft het niveau van ruis aan.
NoiseProperties	Eigenschappen die het ruisniveau van de afbeelding beschrijven.
OcclusionProperties	Eigenschappen die occlusies op een bepaald gezicht beschrijven.
QualityForRecognition	Geeft de kwaliteit van de afbeelding aan voor herkenning.
RecognitionModel	Het herkenningsmodel voor het gezicht.

AccessoryItem

Object

Accessoire-item en bijbehorend betrouwbaarheidsniveau.

Name	Type	Description
confidence	number (float) minimum: 0 maximum: 1	Betrouwbaarheidsniveau van het accessoiretype. Bereik tussen [0,1].
type	AccessoryType	Type van het accessoire.

AccessoryType

Inventarisatie

Type van het accessoire.

Waarde	Description
headwear	Hoofdslijt.
glasses	Bril.
mask	Masker.

BlurLevel

Inventarisatie

Geeft het niveau van wazigheid aan.

Waarde	Description
low	Laag vervaagniveau.
medium	Gemiddeld vervaagniveau.
high	Hoog vervagingsniveau.

BlurProperties

Object

Eigenschappen die de aanwezigheid van vervaging binnen de afbeelding beschrijven.

Name	Type	Description
blurLevel	BlurLevel	Een opsommingswaarde die het niveau van wazigheid aangeeft.
value	number (float) minimum: 0 maximum: 1	Een getal dat het wazigheidsniveau aangeeft, variërend van 0 tot 1.

DetectionModel

Inventarisatie

Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'. 'detection_03' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op kleinere gezichten (64x64 pixels) en gedraaide gezichtsstanden.

Waarde	Description
detection_01	Het standaarddetectiemodel. Aanbevolen voor gezichtsdetectie in de buurt van frontale gezichten. Voor scenario's met uitzonderlijk grote hoek (hoofdhouding) gezichten, occluded gezichten of verkeerde afdrukstand, kunnen de gezichten in dergelijke gevallen niet worden gedetecteerd.
detection_02	Detectiemodel uitgebracht in 2019 met verbeterde nauwkeurigheid, met name op kleine, zij- en wazige gezichten.
detection_03	Detectiemodel uitgebracht in 2021 februari met verbeterde nauwkeurigheid, met name op kleine gezichten.

ExposureLevel

Inventarisatie

Geeft het niveau van blootstelling aan.

Waarde	Description
underExposure	Laag blootstellingsniveau.
goodExposure	Goed blootstellingsniveau.
overExposure	Hoog blootstellingsniveau.

ExposureProperties

Object

Eigenschappen die het belichtingsniveau van de afbeelding beschrijven.

Name	Type	Description
exposureLevel	ExposureLevel	Een opsommingswaarde die het blootstellingsniveau aangeeft.
value	number (float) minimum: 0 maximum: 1	Een getal dat het blootstellingsniveau aangeeft, variërend van 0 tot 1. [0, 0,25) wordt blootgesteld. [0,25, 0,75) is een goede blootstelling. [0,75, 1] is over blootstelling.

FaceAttributes

Object

Gezichtskenmerken voor het gedetecteerde gezicht.

Name	Type	Description
accessories	AccessoryItem[]	Eigenschappen die alle accessoires op een bepaald gezicht beschrijven.
age	number (float)	Leeftijd in jaren.
blur	BlurProperties	Eigenschappen die de aanwezigheid van vervaging binnen de afbeelding beschrijven.
exposure	ExposureProperties	Eigenschappen die het belichtingsniveau van de afbeelding beschrijven.
facialHair	FacialHair	Eigenschappen die gezichtshaarkenmerken beschrijven.
glasses	GlassesType	Briltype als een van het gezicht.
hair	HairProperties	Eigenschappen die haarkenmerken beschrijven.
headPose	HeadPose	3D-rol-/yaw-/pitchhoeken voor gezichtsrichting.
mask	MaskProperties	Eigenschappen die de aanwezigheid van een masker op een bepaald gezicht beschrijven.
noise	NoiseProperties	Eigenschappen die het ruisniveau van de afbeelding beschrijven.
occlusion	OcclusionProperties	Eigenschappen die occlusies op een bepaald gezicht beschrijven.
qualityForRecognition	QualityForRecognition	Eigenschappen die de algehele afbeeldingskwaliteit beschrijven met betrekking tot of de afbeelding die in de detectie wordt gebruikt, voldoende kwaliteit heeft om gezichtsherkenning uit te proberen.
smile	number (float) minimum: 0 maximum: 1	Glimlachintensiteit, een getal tussen [0,1].

FaceAttributeType

Inventarisatie

Analyseer en retourneer een of meer opgegeven gezichtskenmerken in de door komma's gescheiden tekenreeks zoals 'returnFaceAttributes=headPose,bril'. Analyse van gezichtskenmerken heeft extra rekenkundige en tijdskosten.

Waarde	Description
headPose	3D-rol-/yaw-/pitchhoeken voor gezichtsrichting.
glasses	Briltype. Waarden zijn 'NoGlasses', 'ReadingGlasses', 'Zonnebril', 'SwimmingGoggles'.
occlusion	Of elk gezichtsgebied wordt afgekapt, inclusief voorhoofd, ogen en mond.
accessories	Accessoires rondom gezicht, waaronder 'hoofdkleding', 'bril' en 'masker'. Lege matrix betekent dat er geen accessoires zijn gedetecteerd. Let op: dit is nadat een gezicht is gedetecteerd. Groot masker kan ertoe leiden dat er geen gezicht wordt gedetecteerd.
blur	Gezicht is wazig of niet. Niveau retourneert 'Laag', 'Gemiddeld' of 'Hoog'. Waarde retourneert een getal tussen [0,1], hoe groter de waziger.
exposure	Niveau van gezichtsblootstelling. Level retourneert 'GoodExposure', 'OverExposure' of 'UnderExposure'.
noise	Ruisniveau van gezichts pixels. Niveau retourneert 'Laag', 'Gemiddeld' en 'Hoog'. Waarde retourneert een getal tussen [0,1], hoe groter de ruis
mask	Of elk gezicht een masker draagt. Het maskertype retourneert 'noMask', 'faceMask', 'otherMaskOrOcclusion' of 'onzeker'. Waarde retourneert een Booleaanse 'noseAndMouthCovered' die aangeeft of neus en mond bedekt zijn.
qualityForRecognition	De algehele afbeeldingskwaliteit met betrekking tot of de afbeelding die in de detectie wordt gebruikt, voldoende kwaliteit is om gezichtsherkenning uit te proberen. De waarde is een informele waardering van laag, gemiddeld of hoog. Alleen 'afbeeldingen van hoge kwaliteit' worden aanbevolen voor personeninschrijving en kwaliteit op of hoger 'gemiddeld' wordt aanbevolen voor identificatiescenario's. Het kenmerk is alleen beschikbaar bij het gebruik van herkenningsmodellen recognition_03 of recognition_04.
age	Leeftijd in jaren.
smile	Glimlachintensiteit, een getal tussen [0,1].
facialHair	Eigenschappen die gezichtshaarkenmerken beschrijven.
hair	Eigenschappen die haarkenmerken beschrijven.

FaceDetectionResult

Object

Antwoord voor detectie-API.

Name	Type	Description
faceAttributes	FaceAttributes	Gezichtskenmerken voor gedetecteerd gezicht.
faceId	string (uuid)	Unieke faceId van het gedetecteerde gezicht, gemaakt door de detectie-API en verloopt 24 uur na de detectieaanroep. Als u dit wilt retourneren, moet de parameter returnFaceId waar zijn.
faceLandmarks	FaceLandmarks	Een matrix van 27 gezichtsoriëntatiepunten die verwijzen naar de belangrijke posities van gezichtsonderdelen. Als u dit wilt retourneren, moet de parameter returnFaceLandmarks waar zijn.
faceRectangle	FaceRectangle	Een rechthoekgebied voor de gezichtslocatie op de afbeelding.
recognitionModel	RecognitionModel	Het 'recognitionModel' dat is gekoppeld aan deze faceId. Dit wordt alleen geretourneerd wanneer 'returnRecognitionModel' expliciet is ingesteld als waar.

FaceError

Object

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

FaceLandmarks

Object

Een verzameling van 27 gezichtsoriëntatiepunten die verwijzen naar de belangrijke posities van gezichtsonderdelen.

Name	Type	Description
eyeLeftBottom	LandmarkCoordinate	De coördinaten van het linkeroog onderaan.
eyeLeftInner	LandmarkCoordinate	De coördinaten van het linkeroog binnenste.
eyeLeftOuter	LandmarkCoordinate	De coördinaten van het linkeroog buiten.
eyeLeftTop	LandmarkCoordinate	De coördinaten van de linkeroog.
eyeRightBottom	LandmarkCoordinate	De coördinaten van de rechteroog onderaan.
eyeRightInner	LandmarkCoordinate	De coördinaten van het rechteroog binnenste.
eyeRightOuter	LandmarkCoordinate	De coördinaten van het rechteroog buiten.
eyeRightTop	LandmarkCoordinate	De coördinaten van de rechteroog boven.
eyebrowLeftInner	LandmarkCoordinate	De coördinaten van de linker wenkbrauw binnenste.
eyebrowLeftOuter	LandmarkCoordinate	De coördinaten van de linker wenkbrauw buiten.
eyebrowRightInner	LandmarkCoordinate	De coördinaten van de rechter wenkbrauw binnenste.
eyebrowRightOuter	LandmarkCoordinate	De coördinaten van de rechter wenkbrauw buitenste.
mouthLeft	LandmarkCoordinate	De coördinaten van de mond links.
mouthRight	LandmarkCoordinate	De coördinaten van de mond rechts.
noseLeftAlarOutTip	LandmarkCoordinate	De coördinaten van de neus lieten eenlar uit punt achter.
noseLeftAlarTop	LandmarkCoordinate	De coördinaten van de neus linksboven.
noseRightAlarOutTip	LandmarkCoordinate	De coördinaten van de neus rechts alar uit punt.
noseRightAlarTop	LandmarkCoordinate	De coördinaten van de neus rechtsboven.
noseRootLeft	LandmarkCoordinate	De coördinaten van de neuswortel links.
noseRootRight	LandmarkCoordinate	De coördinaten van de neuswortel rechts.
noseTip	LandmarkCoordinate	De coördinaten van de neustip.
pupilLeft	LandmarkCoordinate	De coördinaten van de linkeroog leerling.
pupilRight	LandmarkCoordinate	De coördinaten van de rechteroog leerling.
underLipBottom	LandmarkCoordinate	De coördinaten van de onder lip bodem.
underLipTop	LandmarkCoordinate	De coördinaten van de onder liptop.
upperLipBottom	LandmarkCoordinate	De coördinaten van de bovenlip onderaan.
upperLipTop	LandmarkCoordinate	De coördinaten van de bovenliptop.

FaceRectangle

Object

Een rechthoek waarin een gezicht kan worden gevonden.

Name	Type	Description
height	integer (int32)	De hoogte van de rechthoek, in pixels.
left	integer (int32)	De afstand van de linkerrand als de afbeelding naar de linkerrand van de rechthoek, in pixels.
top	integer (int32)	De afstand van de bovenrand als de afbeelding naar de bovenrand van de rechthoek, in pixels.
width	integer (int32)	De breedte van de rechthoek, in pixels.

FacialHair

Object

Eigenschappen die gezichtshaarkenmerken beschrijven.

Name	Type	Description
beard	number (float) minimum: 0 maximum: 1	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.
moustache	number (float) minimum: 0 maximum: 1	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.
sideburns	number (float) minimum: 0 maximum: 1	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.

GlassesType

Inventarisatie

Briltype van het gezicht.

Waarde	Description
noGlasses	Geen bril op het gezicht.
readingGlasses	Normale bril op het gezicht.
sunglasses	Zonnebril op het gezicht.
swimmingGoggles	Zwemmen goggles op het gezicht.

HairColor

Object

Een matrix van kandidaatkleuren en betrouwbaarheidsniveau in aanwezigheid van elk.

Name	Type	Description
color	HairColorType	Naam van de haarkleur.
confidence	number (float) minimum: 0 maximum: 1	Betrouwbaarheidsniveau van de kleur. Bereik tussen [0,1].

HairColorType

Inventarisatie

Naam van de haarkleur.

Waarde	Description
unknown	Onbekend.
white	Wit.
gray	Grijs.
blond	Blond.
brown	Bruin.
red	Rood.
black	Zwart.
other	Ander.

HairProperties

Object

Eigenschappen die haarkenmerken beschrijven.

Name	Type	Description
bald	number (float) minimum: 0 maximum: 1	Een getal dat het betrouwbaarheidsniveau beschrijft of de persoon kaal is.
hairColor	HairColor[]	Een matrix van kandidaatkleuren en betrouwbaarheidsniveau in aanwezigheid van elk.
invisible	boolean	Een Booleaanse waarde die beschrijft of het haar zichtbaar is in de afbeelding.

HeadPose

Object

3D-rol-/yaw-/pitchhoeken voor gezichtsrichting.

Name	Type	Description
pitch	number (float)	Waarde van hoeken.
roll	number (float)	Waarde van hoeken.
yaw	number (float)	Waarde van hoeken.

LandmarkCoordinate

Object

Oriëntatiepuntcoördinaten binnen een afbeelding.

Name	Type	Description
x	number (float)	Het horizontale onderdeel, in pixels.
y	number (float)	Het verticale onderdeel, in pixels.

MaskProperties

Object

Eigenschappen die de aanwezigheid van een masker op een bepaald gezicht beschrijven.

Name	Type	Description
noseAndMouthCovered	boolean	Een Booleaanse waarde die aangeeft of neus en mond bedekt zijn.
type	MaskType	Type masker.

MaskType

Inventarisatie

Type masker.

Waarde	Description
faceMask	Gezichtsmasker.
noMask	Geen masker.
otherMaskOrOcclusion	Andere soorten masker of occlusie.
uncertain	Onzeker.

NoiseLevel

Inventarisatie

Geeft het niveau van ruis aan.

Waarde	Description
low	Laag ruisniveau.
medium	Gemiddeld ruisniveau.
high	Hoog ruisniveau.

NoiseProperties

Object

Eigenschappen die het ruisniveau van de afbeelding beschrijven.

Name	Type	Description
noiseLevel	NoiseLevel	Een opsommingswaarde die het ruisniveau aangeeft.
value	number (float) minimum: 0 maximum: 1	Een getal dat het geluidsniveau aangeeft, variërend van 0 tot 1. [0, 0,25) wordt blootgesteld. [0,25, 0,75) is een goede blootstelling. [0,75, 1] is over blootstelling. [0, 0,3) is een laag geluidsniveau. [0.3, 0.7) is gemiddeld ruisniveau. [0,7, 1] is een hoog ruisniveau.

OcclusionProperties

Object

Eigenschappen die occlusies op een bepaald gezicht beschrijven.

Name	Type	Description
eyeOccluded	boolean	Een Booleaanse waarde die aangeeft of de ogen zijn afgesloten.
foreheadOccluded	boolean	Een booleaanse waarde die aangeeft of voorhoofd is occluded.
mouthOccluded	boolean	Een Booleaanse waarde die aangeeft of de mond is afgesloten.

QualityForRecognition

Inventarisatie

Geeft de kwaliteit van de afbeelding aan voor herkenning.

Waarde	Description
low	Lage kwaliteit.
medium	Gemiddelde kwaliteit.
high	Hoge kwaliteit.

RecognitionModel

Inventarisatie

Het herkenningsmodel voor het gezicht.

Waarde	Description
recognition_01	Het standaardherkenningsmodel voor 'Detecteren'. Al deze faceIds die vóór 2019 maart zijn gemaakt, worden gekoppeld aan dit herkenningsmodel.
recognition_02	Het herkenningsmodel is uitgebracht in maart 2019.
recognition_03	Het herkenningsmodel is uitgebracht in 2020.
recognition_04	Het herkenningsmodel is uitgebracht in 2021 februari. Het is raadzaam om dit herkenningsmodel te gebruiken voor betere nauwkeurigheid van herkenning.

Delen via

Face Detection Operations - Detect

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

Ocp-Apim-Subscription-Key

AADToken

Bereiken

Voorbeelden

Detect with Image

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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