Face Detection Operations - Detect

Referentie

Service:: Azure AI Services

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

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. Stuur een e-mail naar de Azure Face-API azureface@microsoft.com als u een verantwoorde use case hebt die zou profiteren van het gebruik van een van de beperkte mogelijkheden. Lees meer over deze beslissing https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- 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. Als u verschillende detectiemodellen wilt gebruiken en vergelijken, raadpleegt u https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': Gezichtskenmerken en oriëntatiepunten zijn uitgeschakeld als u dit detectiemodel kiest.
  - 'detection_03': Gezichtskenmerken (masker, vervagen en headPose) en oriëntatiepunten worden ondersteund als u dit detectiemodel kiest.
- 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-modelvoor 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'.
faceIdTimeToLive	query		integer int32	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	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-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>"

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

Accessoire-item en bijbehorend betrouwbaarheidsniveau.

Name	Type	Description
confidence	number	Betrouwbaarheidsniveau van het accessoiretype. Bereik tussen [0,1].
type	AccessoryType	Type van het accessoire.

AccessoryType

Type van het accessoire.

Name	Type	Description
glasses	string	Bril.
headwear	string	Hoofdslijt.
mask	string	Masker.

BlurLevel

Geeft het niveau van wazigheid aan.

Name	Type	Description
high	string	Hoog vervagingsniveau.
low	string	Laag vervaagniveau.
medium	string	Gemiddeld vervaagniveau.

BlurProperties

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	Een getal dat het wazigheidsniveau aangeeft, variërend van 0 tot 1.

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

Name	Type	Description
detection_01	string	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	string	Detectiemodel uitgebracht in 2019 met verbeterde nauwkeurigheid, met name op kleine, zij- en wazige gezichten.
detection_03	string	Detectiemodel uitgebracht in 2021 februari met verbeterde nauwkeurigheid, met name op kleine gezichten.

ExposureLevel

Geeft het niveau van blootstelling aan.

Name	Type	Description
goodExposure	string	Goed blootstellingsniveau.
overExposure	string	Hoog blootstellingsniveau.
underExposure	string	Laag blootstellingsniveau.

ExposureProperties

Eigenschappen die het belichtingsniveau van de afbeelding beschrijven.

Name	Type	Description
exposureLevel	ExposureLevel	Een opsommingswaarde die het blootstellingsniveau aangeeft.
value	number	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

Gezichtskenmerken voor het gedetecteerde gezicht.

Name	Type	Description
accessories	AccessoryItem[]	Eigenschappen die alle accessoires op een bepaald gezicht beschrijven.
age	number	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	Glimlachintensiteit, een getal tussen [0,1].

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.

Name	Type	Description
accessories	string	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.
age	string	Leeftijd in jaren.
blur	string	Gezicht is wazig of niet. Niveau retourneert 'Laag', 'Gemiddeld' of 'Hoog'. Waarde retourneert een getal tussen [0,1], hoe groter de waziger.
exposure	string	Niveau van gezichtsblootstelling. Level retourneert 'GoodExposure', 'OverExposure' of 'UnderExposure'.
facialHair	string	Eigenschappen die gezichtshaarkenmerken beschrijven.
glasses	string	Briltype. Waarden zijn 'NoGlasses', 'ReadingGlasses', 'Zonnebril', 'SwimmingGoggles'.
hair	string	Eigenschappen die haarkenmerken beschrijven.
headPose	string	3D-rol-/yaw-/pitchhoeken voor gezichtsrichting.
mask	string	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.
noise	string	Ruisniveau van gezichts pixels. Niveau retourneert 'Laag', 'Gemiddeld' en 'Hoog'. Waarde retourneert een getal tussen [0,1], hoe groter de ruis
occlusion	string	Of elk gezichtsgebied wordt afgekapt, inclusief voorhoofd, ogen en mond.
qualityForRecognition	string	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.
smile	string	Glimlachintensiteit, een getal tussen [0,1].

FaceDetectionResult

Antwoord voor detectie-API.

Name	Type	Description
faceAttributes	FaceAttributes	Gezichtskenmerken voor gedetecteerd gezicht.
faceId	string	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

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

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

FaceLandmarks

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

Een rechthoek waarin een gezicht kan worden gevonden.

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

FacialHair

Eigenschappen die gezichtshaarkenmerken beschrijven.

Name	Type	Description
beard	number	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.
moustache	number	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.
sideburns	number	Een getal tussen 0 en 1 dat een betrouwbaarheidsniveau aangeeft dat aan een eigenschap is gekoppeld.

GlassesType

Briltype van het gezicht.

Name	Type	Description
noGlasses	string	Geen bril op het gezicht.
readingGlasses	string	Normale bril op het gezicht.
sunglasses	string	Zonnebril op het gezicht.
swimmingGoggles	string	Zwemmen goggles op het gezicht.

HairColor

Een matrix van kandidaatkleuren en betrouwbaarheidsniveau in aanwezigheid van elk.

Name	Type	Description
color	HairColorType	Naam van de haarkleur.
confidence	number	Betrouwbaarheidsniveau van de kleur. Bereik tussen [0,1].

HairColorType

Naam van de haarkleur.

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

HairProperties

Eigenschappen die haarkenmerken beschrijven.

Name	Type	Description
bald	number	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

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

Name	Type	Description
pitch	number	Waarde van hoeken.
roll	number	Waarde van hoeken.
yaw	number	Waarde van hoeken.

LandmarkCoordinate

Oriëntatiepuntcoördinaten binnen een afbeelding.

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

MaskProperties

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

Type masker.

Name	Type	Description
faceMask	string	Gezichtsmasker.
noMask	string	Geen masker.
otherMaskOrOcclusion	string	Andere soorten masker of occlusie.
uncertain	string	Onzeker.

NoiseLevel

Geeft het niveau van ruis aan.

Name	Type	Description
high	string	Hoog ruisniveau.
low	string	Laag ruisniveau.
medium	string	Gemiddeld ruisniveau.

NoiseProperties

Eigenschappen die het ruisniveau van de afbeelding beschrijven.

Name	Type	Description
noiseLevel	NoiseLevel	Een opsommingswaarde die het ruisniveau aangeeft.
value	number	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

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

Geeft de kwaliteit van de afbeelding aan voor herkenning.

Name	Type	Description
high	string	Hoge kwaliteit.
low	string	Lage kwaliteit.
medium	string	Gemiddelde kwaliteit.

RecognitionModel

Het herkenningsmodel voor het gezicht.

Name	Type	Description
recognition_01	string	Het standaardherkenningsmodel voor 'Detecteren'. Al deze faceIds die vóór 2019 maart zijn gemaakt, worden gekoppeld aan dit herkenningsmodel.
recognition_02	string	Het herkenningsmodel is uitgebracht in maart 2019.
recognition_03	string	Het herkenningsmodel is uitgebracht in 2020.
recognition_04	string	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

Aanvullende resources