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 till Azure Face API azureface@microsoft.com om du har ett ansvarsfullt användningsfall som skulle dra nytta av någon av de begränsade funktionerna. Läs mer om det här beslutet https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- 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. Om du vill använda och jämföra olika identifieringsmodeller kan du läsa https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - "detection_02": Ansiktsattribut och landmärken inaktiveras om du väljer den här identifieringsmodellen.
  - "detection_03": Ansiktsattribut (mask, oskärpa och headPose) och landmärken stöds om du väljer den här identifieringsmodellen.
- 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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".
faceIdTimeToLive	query		integer int32	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	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".
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

Tillbehörsobjekt och motsvarande konfidensnivå.

Name	Typ	Description
confidence	number	Konfidensnivå för tillbehörstypen. Intervall mellan [0,1].
type	AccessoryType	Typ av tillbehör.

AccessoryType

Typ av tillbehör.

Name	Typ	Description
glasses	string	Glasögon.
headwear	string	Huvudslitage.
mask	string	Mask.

BlurLevel

Anger suddighetsnivå.

Name	Typ	Description
high	string	Hög oskärpa.
low	string	Låg oskärpa.
medium	string	Medelhög oskärpa.

BlurProperties

Egenskaper som beskriver eventuell oskärpa i bilden.

Name	Typ	Description
blurLevel	BlurLevel	Ett uppräkningsvärde som anger suddighetsnivå.
value	number	Ett tal som anger suddighetsnivå från 0 till 1.

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

Name	Typ	Description
detection_01	string	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	string	Identifieringsmodell som släpptes 2019 maj med förbättrad noggrannhet, särskilt på små, sido- och suddiga ansikten.
detection_03	string	Identifieringsmodell som släpptes 2021 februari med förbättrad noggrannhet, särskilt på små ansikten.

ExposureLevel

Anger exponeringsnivå.

Name	Typ	Description
goodExposure	string	God exponeringsnivå.
overExposure	string	Hög exponeringsnivå.
underExposure	string	Låg exponeringsnivå.

ExposureProperties

Egenskaper som beskriver exponeringsnivån för bilden.

Name	Typ	Description
exposureLevel	ExposureLevel	Ett uppräkningsvärde som anger exponeringsnivån.
value	number	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

Ansiktsattribut för det identifierade ansiktet.

Name	Typ	Description
accessories	AccessoryItem[]	Egenskaper som beskriver tillbehör på ett givet ansikte.
age	number	Å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	Leende intensitet, ett tal mellan [0,1].

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.

Name	Typ	Description
accessories	string	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	string	Ålder i år.
blur	string	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	string	Exponeringsnivå för ansikte. Nivån returnerar "GoodExposure", "OverExposure" eller "UnderExposure".
facialHair	string	Egenskaper som beskriver attribut för ansiktshår.
glasses	string	Glasögontyp. Värdena är "NoGlasses", "ReadingGlasses", "Solglasögon", "SwimmingGoggles".
hair	string	Egenskaper som beskriver hårattribut.
headPose	string	3D-rulle/gäsp/lutningsvinklar för ansiktsriktning.
mask	string	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	string	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	string	Om varje ansiktsyta är ockluderad, inklusive panna, ögon och mun.
qualityForRecognition	string	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	string	Leende intensitet, ett tal mellan [0,1].

FaceDetectionResult

Svar för att identifiera API.

Name	Typ	Description
faceAttributes	FaceAttributes	Ansiktsattribut för identifierat ansikte.
faceId	string	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

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

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.

FaceLandmarks

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

En rektangel där ett ansikte kan hittas.

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

FacialHair

Egenskaper som beskriver attribut för ansiktshår.

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

GlassesType

Glasögon typ av ansikte.

Name	Typ	Description
noGlasses	string	Inga glasögon i ansiktet.
readingGlasses	string	Normala glasögon i ansiktet.
sunglasses	string	Solglasögon i ansiktet.
swimmingGoggles	string	Badglasögon i ansiktet.

HairColor

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	Konfidensnivå för färgen. Intervall mellan [0,1].

HairColorType

Namnet på hårfärgen.

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

HairProperties

Egenskaper som beskriver hårattribut.

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

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

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

LandmarkCoordinate

Landmärkeskoordinater i en bild.

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

MaskProperties

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

Maskens typ.

Name	Typ	Description
faceMask	string	Ansiktsmask.
noMask	string	Ingen mask.
otherMaskOrOcclusion	string	Andra typer av mask eller ocklusion.
uncertain	string	Osäker.

NoiseLevel

Anger brusnivå.

Name	Typ	Description
high	string	Hög brusnivå.
low	string	Låg brusnivå.
medium	string	Medelhög brusnivå.

NoiseProperties

Egenskaper som beskriver brusnivån i bilden.

Name	Typ	Description
noiseLevel	NoiseLevel	Ett uppräkningsvärde som anger brusnivån.
value	number	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

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

Anger bildkvalitet för igenkänning.

Name	Typ	Description
high	string	Hög kvalitet.
low	string	Låg kvalitet.
medium	string	Medelhög kvalitet.

RecognitionModel

Igenkänningsmodellen för ansiktet.

Name	Typ	Description
recognition_01	string	Standardigenkänningsmodellen för "Detect". Alla faceIds som skapades före mars 2019 är kopplade till den här igenkänningsmodellen.
recognition_02	string	Igenkänningsmodellen släpptes 2019 mars.
recognition_03	string	Igenkänningsmodell som släpptes 2020 maj.
recognition_04	string	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