Face Detection Operations - Detect

Referens

Tjänst:: Azure AI Services

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

Identifiera mänskliga ansikten i en bild, returnera ansiktsrektanglar och eventuellt med faceId, landmärken och attribut.

Viktig

Microsoft har dragit tillbaka eller begränsade funktioner för ansiktsigenkänning som kan användas för att försöka härleda känslomässiga tillstånd och identitetsattribut som, om de missbrukas, kan utsätta människor för stereotyper, diskriminering eller orättvis överbelastning av tjänster. De pensionerade funktionerna är känslor och kön. De begränsade funktionerna är ålder, leende, ansiktshår, hår och smink. Skicka e-post Azure Face API- om du har ett ansvarsfullt användningsfall som kan dra nytta av någon av de begränsade funktionerna. Läs mer om det här beslutet här.

- Ingen avbildning kommer att lagras. Endast de extraherade ansiktsfunktionerna lagras på servern. FaceId är en identifierare för ansiktsfunktionen och används i "Identifiera", "Verifiera" och "Hitta liknande". De lagrade ansiktsfunktionerna upphör att gälla och tas bort vid den tidpunkt som anges av faceIdTimeToLive efter det ursprungliga identifieringsanropet.
- Valfria parametrar är faceId, landmärken och attribut. Attributen omfattar headPose, glasögon, ocklusion, tillbehör, oskärpa, exponering, brus, mask och kvalitetForRecognition. Vissa av de resultat som returneras för specifika attribut kanske inte är mycket exakta.
- JPEG, PNG, GIF (den första ramen) och BMP-format stöds. Den tillåtna bildfilens storlek är från 1 KB till 6 MB.
- Den minsta detekterbara ansiktsstorleken är 36 x 36 bildpunkter i en bild som inte är större än 1920x1080 bildpunkter. Bilder med dimensioner som är högre än 1920 x 1 080 bildpunkter behöver en proportionellt större minsta ansiktsstorlek.
- Upp till 100 ansikten kan returneras för en bild. Ansikten rangordnas efter ansiktsrektangelstorlek från stor till liten.
- För optimala resultat när du frågar "Identifiera", "Verifiera" och "Hitta liknande" ("returnFaceId" är sant) använder du ansikten som är: frontal, klar och med en minsta storlek på 200 x 200 bildpunkter (100 bildpunkter mellan ögonen).
- Olika "detectionModel"-värden kan anges. Tillgängligheten för landmärken och attribut som stöds beror på den angivna identifieringsmodellen. Om du vill använda och jämföra olika identifieringsmodeller kan du läsa här.
- Olika "recognitionModel"-värden tillhandahålls. Om uppföljningsåtgärder som "Verify", "Identify", "Find Similar" krävs anger du igenkänningsmodellen med parametern "recognitionModel". Standardvärdet för "recognitionModel" är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell som du behöver i den här parametern. När de identifierade faceId:erna har angetts associeras de med den angivna igenkänningsmodellen. Mer information finns i här.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string (uri)	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	"detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01". "detection_03" rekommenderas eftersom dess noggrannhet förbättras på mindre ansikten (64 x 64 bildpunkter) och roterade ansiktsorienteringar.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Antalet sekunder för ansikts-ID:t som cachelagras. Stöd för intervall från 60 sekunder upp till 86400 sekunder. Standardvärdet är 86400 (24 timmar).
recognitionModel	query		RecognitionModel	Den "recognitionModel" som är associerad med identifierade faceIds. "recognitionModel"-värden som stöds är "recognition_01", "recognition_02", "recognition_03" eller "recognition_04". Standardvärdet är "recognition_01". "recognition_04" rekommenderas eftersom dess noggrannhet förbättras på ansikten som bär masker jämfört med "recognition_03", och dess övergripande noggrannhet förbättras jämfört med "recognition_01" och "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Analysera och returnera ett eller flera angivna ansiktsattribut i kommaavgränsad sträng som "returnFaceAttributes=headPose,glasses". Ansiktsattributanalys har ytterligare beräknings- och tidskostnad.
returnFaceId	query		boolean	Returnera faceIds för de identifierade ansiktena eller inte. Standardvärdet är sant.
returnFaceLandmarks	query		boolean	Returnera ansiktsmärken för de identifierade ansiktena eller inte. Standardvärdet är falskt.
returnRecognitionModel	query		boolean	Returnera "recognitionModel" eller inte. Standardvärdet är falskt. Detta gäller endast när returnFaceId = true.

Begärandetext

Media Types: "application/octet-stream"

Name	Typ	Description
imageContent	string (binary)	Binärt indatabild.

Svar

Name	Typ	Description
200 OK	FaceDetectionResult[]	Ett lyckat anrop returnerar en matris med ansiktsposter rangordnade efter ansiktsrektangelstorlek i fallande ordning. Ett tomt svar anger att inga ansikten har identifierats.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Name

Typ

Description

200 OK

FaceDetectionResult[]

Ett lyckat anrop returnerar en matris med ansiktsposter rangordnade efter ansiktsrektangelstorlek i fallande ordning. Ett tomt svar anger att inga ansikten har identifierats.

Other Status Codes

FaceErrorResponse

Ett oväntat felsvar.

Sidhuvuden

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Detect with Image

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
AccessoryItem	Tillbehörsobjekt och motsvarande konfidensnivå.
AccessoryType	Typ av tillbehör.
BlurLevel	Anger suddighetsnivå.
BlurProperties	Egenskaper som beskriver eventuell oskärpa i bilden.
DetectionModel	"detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01". "detection_03" rekommenderas eftersom dess noggrannhet förbättras på mindre ansikten (64 x 64 bildpunkter) och roterade ansiktsorienteringar.
ExposureLevel	Anger exponeringsnivå.
ExposureProperties	Egenskaper som beskriver exponeringsnivån för bilden.
FaceAttributes	Ansiktsattribut för det identifierade ansiktet.
FaceAttributeType	Analysera och returnera ett eller flera angivna ansiktsattribut i kommaavgränsad sträng som "returnFaceAttributes=headPose,glasses". Ansiktsattributanalys har ytterligare beräknings- och tidskostnad.
FaceDetectionResult	Svar för att identifiera API.
FaceError	Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
FaceLandmarks	En samling av 27-punkts ansiktsmärken som pekar på de viktiga positionerna för ansiktskomponenter.
FaceRectangle	En rektangel där ett ansikte kan hittas.
FacialHair	Egenskaper som beskriver attribut för ansiktshår.
GlassesType	Glasögon typ av ansikte.
HairColor	En matris med kandidatfärger och konfidensnivå i närvaro av var och en.
HairColorType	Namnet på hårfärgen.
HairProperties	Egenskaper som beskriver hårattribut.
HeadPose	3D-rulle/gäsp/lutningsvinklar för ansiktsriktning.
LandmarkCoordinate	Landmärkeskoordinater i en bild.
MaskProperties	Egenskaper som beskriver förekomsten av en mask i ett visst ansikte.
MaskType	Maskens typ.
NoiseLevel	Anger brusnivå.
NoiseProperties	Egenskaper som beskriver brusnivån i bilden.
OcclusionProperties	Egenskaper som beskriver ocklusioner på ett visst ansikte.
QualityForRecognition	Anger bildkvalitet för igenkänning.
RecognitionModel	Igenkänningsmodellen för ansiktet.

AccessoryItem

Objekt

Tillbehörsobjekt och motsvarande konfidensnivå.

Name	Typ	Description
confidence	number (float) minimum: 0 maximum: 1	Konfidensnivå för tillbehörstypen. Intervall mellan [0,1].
type	AccessoryType	Typ av tillbehör.

AccessoryType

Uppräkning

Typ av tillbehör.

Värde	Description
glasses	Glasögon.
headwear	Huvudslitage.
mask	Mask.

BlurLevel

Uppräkning

Anger suddighetsnivå.

Värde	Description
high	Hög oskärpa.
low	Låg oskärpa.
medium	Medelhög oskärpa.

BlurProperties

Objekt

Egenskaper som beskriver eventuell oskärpa i bilden.

Name	Typ	Description
blurLevel	BlurLevel	Ett uppräkningsvärde som anger suddighetsnivå.
value	number (float) minimum: 0 maximum: 1	Ett tal som anger suddighetsnivå från 0 till 1.

DetectionModel

Uppräkning

"detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01". "detection_03" rekommenderas eftersom dess noggrannhet förbättras på mindre ansikten (64 x 64 bildpunkter) och roterade ansiktsorienteringar.

Värde	Description
detection_01	Standardidentifieringsmodellen. Rekommendera för nästan frontal ansiktsidentifiering. För scenarier med exceptionellt stora vinkeln (huvud-pose) ansikten, ockluderade ansikten eller fel bildorientering, ansikten i sådana fall kanske inte identifieras.
detection_02	Identifieringsmodell som släpptes 2019 maj med förbättrad noggrannhet, särskilt på små, sido- och suddiga ansikten.
detection_03	Identifieringsmodell som släpptes 2021 februari med förbättrad noggrannhet, särskilt på små ansikten.

ExposureLevel

Uppräkning

Anger exponeringsnivå.

Värde	Description
goodExposure	God exponeringsnivå.
overExposure	Hög exponeringsnivå.
underExposure	Låg exponeringsnivå.

ExposureProperties

Objekt

Egenskaper som beskriver exponeringsnivån för bilden.

Name	Typ	Description
exposureLevel	ExposureLevel	Ett uppräkningsvärde som anger exponeringsnivån.
value	number (float) minimum: 0 maximum: 1	Ett tal som anger exponeringsnivån mellan 0 och 1. [0, 0,25) är under exponering. [0,25, 0,75) är god exponering. [0,75, 1] är över exponering.

FaceAttributes

Objekt

Ansiktsattribut för det identifierade ansiktet.

Name	Typ	Description
accessories	AccessoryItem[]	Egenskaper som beskriver tillbehör på ett givet ansikte.
age	number (float)	Ålder i år.
blur	BlurProperties	Egenskaper som beskriver eventuell oskärpa i bilden.
exposure	ExposureProperties	Egenskaper som beskriver exponeringsnivån för bilden.
facialHair	FacialHair	Egenskaper som beskriver attribut för ansiktshår.
glasses	GlassesType	Glasögon skriver om något av ansiktet.
hair	HairProperties	Egenskaper som beskriver hårattribut.
headPose	HeadPose	3D-rulle/gäsp/lutningsvinklar för ansiktsriktning.
mask	MaskProperties	Egenskaper som beskriver förekomsten av en mask i ett visst ansikte.
noise	NoiseProperties	Egenskaper som beskriver brusnivån i bilden.
occlusion	OcclusionProperties	Egenskaper som beskriver ocklusioner på ett visst ansikte.
qualityForRecognition	QualityForRecognition	Egenskaper som beskriver den övergripande bildkvaliteten för huruvida den bild som används i identifieringen är av tillräcklig kvalitet för att försöka känna igen ansiktet på.
smile	number (float) minimum: 0 maximum: 1	Leende intensitet, ett tal mellan [0,1].

FaceAttributeType

Uppräkning

Analysera och returnera ett eller flera angivna ansiktsattribut i kommaavgränsad sträng som "returnFaceAttributes=headPose,glasses". Ansiktsattributanalys har ytterligare beräknings- och tidskostnad.

Värde	Description
accessories	Tillbehör runt ansiktet, inklusive "huvudbonader", "glasögon" och "mask". Tom matris innebär att inga tillbehör har identifierats. Observera att detta är när ett ansikte har identifierats. Stor mask kan leda till att inget ansikte identifieras.
age	Ålder i år.
blur	Ansiktet är suddigt eller inte. Nivån returnerar "Low", "Medium" eller "High". Värdet returnerar ett tal mellan [0,1], desto större blir suddigare.
exposure	Exponeringsnivå för ansikte. Nivån returnerar "GoodExposure", "OverExposure" eller "UnderExposure".
facialHair	Egenskaper som beskriver attribut för ansiktshår.
glasses	Glasögontyp. Värdena är "NoGlasses", "ReadingGlasses", "Solglasögon", "SwimmingGoggles".
hair	Egenskaper som beskriver hårattribut.
headPose	3D-rulle/gäsp/lutningsvinklar för ansiktsriktning.
mask	Om varje ansikte bär mask. Masktypen returnerar "noMask", "faceMask", "otherMaskOrOcclusion" eller "uncertain". Värdet returnerar en boolesk "noseAndMouthCovered" som anger om näsa och mun är täckta.
noise	Brusnivå för ansiktspixlar. Nivån returnerar "Low", "Medium" och "High". Värdet returnerar ett tal mellan [0,1], desto större blir bullrigare
occlusion	Om varje ansiktsyta är ockluderad, inklusive panna, ögon och mun.
qualityForRecognition	Den övergripande bildkvaliteten om huruvida den bild som används i identifieringen är av tillräcklig kvalitet för att försöka känna igen ansiktet på. Värdet är ett informellt omdöme av låg, medel eller hög. Endast bilder av hög kvalitet rekommenderas för personregistrering och kvalitet på eller över "medium" rekommenderas för identifieringsscenarier. Attributet är endast tillgängligt när du använder igenkänningsmodeller recognition_03 eller recognition_04.
smile	Leende intensitet, ett tal mellan [0,1].

FaceDetectionResult

Objekt

Svar för att identifiera API.

Name	Typ	Description
faceAttributes	FaceAttributes	Ansiktsattribut för identifierat ansikte.
faceId	string (uuid)	Unikt faceId för det identifierade ansiktet, skapat av identifierings-API:et och det upphör att gälla 24 timmar efter identifieringsanropet. För att returnera detta krävs parametern "returnFaceId" för att vara sant.
faceLandmarks	FaceLandmarks	En matris med landmärken med 27 punkters ansiktsigenkänning som pekar på ansiktskomponenternas viktiga positioner. För att returnera detta krävs parametern "returnFaceLandmarks" för att vara sant.
faceRectangle	FaceRectangle	Ett rektangelområde för ansiktsplatsen på bilden.
recognitionModel	RecognitionModel	Det "recognitionModel" som är associerat med det här faceId:et. Detta returneras endast när "returnRecognitionModel" uttryckligen anges som true.

FaceError

Objekt

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En mänsklig läsbar representation av felet.

FaceErrorResponse

Objekt

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.

FaceLandmarks

Objekt

En samling av 27-punkts ansiktsmärken som pekar på de viktiga positionerna för ansiktskomponenter.

Name	Typ	Description
eyeLeftBottom	LandmarkCoordinate	Koordinaterna för det vänstra ögats nedre del.
eyeLeftInner	LandmarkCoordinate	Koordinaterna för det vänstra ögat inre.
eyeLeftOuter	LandmarkCoordinate	Koordinaterna för vänster öga yttre.
eyeLeftTop	LandmarkCoordinate	Koordinaterna för det vänstra ögats överkant.
eyeRightBottom	LandmarkCoordinate	Koordinaterna för den högra ögonbotten.
eyeRightInner	LandmarkCoordinate	Koordinaterna för det högra ögat inre.
eyeRightOuter	LandmarkCoordinate	Koordinaterna för höger öga yttre.
eyeRightTop	LandmarkCoordinate	Koordinaterna för det högra ögats överkant.
eyebrowLeftInner	LandmarkCoordinate	Koordinaterna för det vänstra ögonbrynet inre.
eyebrowLeftOuter	LandmarkCoordinate	Koordinaterna för det vänstra ögonbrynet yttre.
eyebrowRightInner	LandmarkCoordinate	Koordinaterna för höger ögonbryn inre.
eyebrowRightOuter	LandmarkCoordinate	Koordinaterna för höger ögonbryn yttre.
mouthLeft	LandmarkCoordinate	Koordinaterna för munnen till vänster.
mouthRight	LandmarkCoordinate	Koordinaterna för munnen höger.
noseLeftAlarOutTip	LandmarkCoordinate	Näskoordinaterna lämnade alar ut spets.
noseLeftAlarTop	LandmarkCoordinate	Näskoordinaterna lämnade alar överst.
noseRightAlarOutTip	LandmarkCoordinate	Koordinaterna för näsan höger alar ut spets.
noseRightAlarTop	LandmarkCoordinate	Koordinaterna för näsan höger alar topp.
noseRootLeft	LandmarkCoordinate	Koordinaterna för nosroten till vänster.
noseRootRight	LandmarkCoordinate	Koordinaterna för näsan rot höger.
noseTip	LandmarkCoordinate	Nässpetsens koordinater.
pupilLeft	LandmarkCoordinate	Koordinaterna för vänster ögonelev.
pupilRight	LandmarkCoordinate	Koordinaterna för höger ögonelev.
underLipBottom	LandmarkCoordinate	Koordinaterna för underläppen.
underLipTop	LandmarkCoordinate	Koordinaterna för underläppen.
upperLipBottom	LandmarkCoordinate	Koordinaterna för överläppens botten.
upperLipTop	LandmarkCoordinate	Koordinaterna för överläppens överkant.

FaceRectangle

Objekt

En rektangel där ett ansikte kan hittas.

Name	Typ	Description
height	integer (int32)	Rektangelns höjd i bildpunkter.
left	integer (int32)	Avståndet från den vänstra kanten om bilden till den vänstra kanten av rektangeln, i bildpunkter.
top	integer (int32)	Avståndet från den övre kanten om bilden till rektangelns övre kant, i bildpunkter.
width	integer (int32)	Rektangelns bredd i bildpunkter.

FacialHair

Objekt

Egenskaper som beskriver attribut för ansiktshår.

Name	Typ	Description
beard	number (float) minimum: 0 maximum: 1	Ett tal mellan 0 och 1 som anger en konfidensnivå som är associerad med en egenskap.
moustache	number (float) minimum: 0 maximum: 1	Ett tal mellan 0 och 1 som anger en konfidensnivå som är associerad med en egenskap.
sideburns	number (float) minimum: 0 maximum: 1	Ett tal mellan 0 och 1 som anger en konfidensnivå som är associerad med en egenskap.

GlassesType

Uppräkning

Glasögon typ av ansikte.

Värde	Description
noGlasses	Inga glasögon i ansiktet.
readingGlasses	Normala glasögon i ansiktet.
sunglasses	Solglasögon i ansiktet.
swimmingGoggles	Badglasögon i ansiktet.

HairColor

Objekt

En matris med kandidatfärger och konfidensnivå i närvaro av var och en.

Name	Typ	Description
color	HairColorType	Namnet på hårfärgen.
confidence	number (float) minimum: 0 maximum: 1	Konfidensnivå för färgen. Intervall mellan [0,1].

HairColorType

Uppräkning

Namnet på hårfärgen.

Värde	Description
black	Svart.
blond	Blond.
brown	Brun.
gray	Grå.
other	Annan.
red	Röd.
unknown	Okänd.
white	Vit.

HairProperties

Objekt

Egenskaper som beskriver hårattribut.

Name	Typ	Description
bald	number (float) minimum: 0 maximum: 1	Ett nummer som beskriver konfidensnivån för huruvida personen är skallig.
hairColor	HairColor[]	En matris med kandidatfärger och konfidensnivå i närvaro av var och en.
invisible	boolean	Ett booleskt värde som beskriver om håret är synligt i bilden.

HeadPose

Objekt

3D-rulle/gäsp/lutningsvinklar för ansiktsriktning.

Name	Typ	Description
pitch	number (float)	Värde för vinklar.
roll	number (float)	Värde för vinklar.
yaw	number (float)	Värde för vinklar.

LandmarkCoordinate

Objekt

Landmärkeskoordinater i en bild.

Name	Typ	Description
x	number (float)	Den vågräta komponenten, i bildpunkter.
y	number (float)	Den lodräta komponenten i bildpunkter.

MaskProperties

Objekt

Egenskaper som beskriver förekomsten av en mask i ett visst ansikte.

Name	Typ	Description
noseAndMouthCovered	boolean	Ett booleskt värde som anger om näsa och mun är täckta.
type	MaskType	Maskens typ.

MaskType

Uppräkning

Maskens typ.

Värde	Description
faceMask	Ansiktsmask.
noMask	Ingen mask.
otherMaskOrOcclusion	Andra typer av mask eller ocklusion.
uncertain	Osäker.

NoiseLevel

Uppräkning

Anger brusnivå.

Värde	Description
high	Hög brusnivå.
low	Låg brusnivå.
medium	Medelhög brusnivå.

NoiseProperties

Objekt

Egenskaper som beskriver brusnivån i bilden.

Name	Typ	Description
noiseLevel	NoiseLevel	Ett uppräkningsvärde som anger brusnivån.
value	number (float) minimum: 0 maximum: 1	Ett tal som anger ljudnivån från 0 till 1. [0, 0,25) är under exponering. [0,25, 0,75) är god exponering. [0,75, 1] är över exponering. [0, 0.3) är låg brusnivå. [0.3, 0.7) är medelhög brusnivå. [0,7, 1] är hög brusnivå.

OcclusionProperties

Objekt

Egenskaper som beskriver ocklusioner på ett visst ansikte.

Name	Typ	Description
eyeOccluded	boolean	Ett booleskt värde som anger om ögonen är ockluderade.
foreheadOccluded	boolean	Ett booleskt värde som anger om pannan är ockluderad.
mouthOccluded	boolean	Ett booleskt värde som anger om munnen är ockluderad.

QualityForRecognition

Uppräkning

Anger bildkvalitet för igenkänning.

Värde	Description
high	Hög kvalitet.
low	Låg kvalitet.
medium	Medelhög kvalitet.

RecognitionModel

Uppräkning

Igenkänningsmodellen för ansiktet.

Värde	Description
recognition_01	Standardigenkänningsmodellen för "Detect". Alla faceIds som skapades före mars 2019 är kopplade till den här igenkänningsmodellen.
recognition_02	Igenkänningsmodellen släpptes 2019 mars.
recognition_03	Igenkänningsmodell som släpptes 2020 maj.
recognition_04	Igenkänningsmodellen släpptes 2021 februari. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsnoggrannhet.

Dela via

Face Detection Operations - Detect

URI-parametrar

Begärandetext

Svar

Säkerhet

Ocp-Apim-Subscription-Key

AADToken

Omfattningar

Exempel

Detect with Image

Exempelbegäran

Exempelsvar

Definitioner

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

Ytterligare resurser