Face Detection Operations - Detect

Referens

Tjänst:: Azure AI Services

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

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

Viktigt

För att minimera potentiellt missbruk som kan utsätta människor för stereotyper, diskriminering eller orättvis förnekelse av tjänster, drar vi tillbaka Ansikts-API-attribut som förutsäger känslor, kön, ålder, leende, ansiktshår, hår och smink. 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 kommer att användas 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 korrekta.
- JPEG, PNG, GIF (den första ramen) och BMP-format stöds. Den tillåtna bildfilstorleken är från 1 KB till 6 MB.
- Den minsta identifierbara ansiktsstorleken är 36 x 36 bildpunkter i en bild som inte är större än 1920 x 1 080 bildpunkter. Bilder med dimensioner som är högre än 1920 x 1080 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.
- Om du vill ha optimala resultat när du frågar "Identifiera", "Verifiera" och "Hitta liknande" ("returnFaceId" är sant) använder du ansikten som är: frontal, clear och med en minsta storlek på 200 x 200 bildpunkter (100 bildpunkter mellan ögonen).
- Olika "detectionModel"-värden kan anges. Information om hur du använder och jämför olika identifieringsmodeller finns i 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	Den "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ödintervall från 60 sekunder upp till 86 400 sekunder. Standardvärdet är 86400 (24 timmar).
recognitionModel	query		RecognitionModel	Den "recognitionModel" som är associerad med identifierade faceIds. Värden för "recognitionModel" 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 den kommaavgränsade strängen, till exempel "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 True.
returnFaceLandmarks	query		boolean	Returnera ansiktsmärken för de identifierade ansiktena eller inte. Standardvärdet är false.
returnRecognitionModel	query		boolean	Returnera "recognitionModel" eller inte. Standardvärdet är false. Detta gäller endast när returnFaceId = true.

Begärandetext

Media Types: "application/octet-stream"

Name	Typ	Description
imageContent	string	Den binära indatabilden.

Svar

Name	Typ	Description
200 OK	FaceDetectionResult[]	Ett lyckat anrop returnerar en matris med ansiktsposter rangordnade efter ansiktsrektangelns storlek 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 ansiktsrektangelns storlek 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 Ansiktsprenumeration på Azure AI.

Typ: apiKey
I: header

AADToken

Azure Active Directory OAuth2-flödet

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.1-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

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	Den "detectionModel" som är associerad med de identifierade faceId:erna. "detectionModel"-värden som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01".
ExposureLevel	Anger exponeringsnivån.
ExposureProperties	Egenskaper som beskriver bildens exponeringsnivå.
FaceAttributes	Ansiktsattribut för det identifierade ansiktet.
FaceAttributeType	Analysera och returnera ett eller flera angivna ansiktsattribut i den kommaavgränsade strängen som "returnFaceAttributes=headPose,glasses". Ansiktsattributanalys har ytterligare beräknings- och tidskostnad.
FaceDetectionResult	Svar för identifierings-API.
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
FaceLandmarks	En samling ansiktsmärken med 27 punkter som pekar på ansiktskomponenternas viktiga positioner.
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 varje.
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 på ett visst ansikte.
MaskType	Typ av mask.
NoiseLevel	Anger brusnivå.
NoiseProperties	Egenskaper som beskriver bildens brusnivå.
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	Medelmörk oskärpa.

BlurProperties

Egenskaper som beskriver eventuell oskärpa i bilden.

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

DetectionModel

Den "detectionModel" som är associerad med de identifierade faceId:erna. "detectionModel"-värden 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 identifiering av ansiktsigenkänning i nära fronten. För scenarier med exceptionellt stora vinkelansikten (huvudposition), occluded ansikten eller felaktig bildorientering, kan det hända att ansikten i sådana fall 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 i februari 2021 med bättre noggrannhet, särskilt för små ansikten.

ExposureLevel

Anger exponeringsnivån.

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

ExposureProperties

Egenskaper som beskriver bildens exponeringsnivå.

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

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 bildens exponeringsnivå.
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 på ett visst ansikte.
noise	NoiseProperties	Egenskaper som beskriver bildens brusnivå.
occlusion	OcclusionProperties	Egenskaper som beskriver ocklusioner på ett visst ansikte.
qualityForRecognition	QualityForRecognition	Egenskaper som beskriver den övergripande bildkvaliteten för huruvida bilden som används i identifieringen är av tillräcklig kvalitet för att försöka identifiera ansikten.
smile	number	Leende intensitet, ett tal mellan [0,1].

FaceAttributeType

Analysera och returnera ett eller flera angivna ansiktsattribut i den kommaavgränsade strängen 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 det 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 inkluderar "NoGlasses", "ReadingGlasses", "Sunglasses", "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 ett booleskt "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 är bullraren
occlusion	string	Om varje ansiktsyta är ockluderad, inklusive panna, ögon och mun.
qualityForRecognition	string	Den övergripande bildkvaliteten för huruvida den bild som används i identifieringen är av tillräcklig kvalitet för att försöka identifiera ansikten. 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 identifierings-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äver det att parametern returnFaceId är true.
faceLandmarks	FaceLandmarks	En matris med ansiktslandmärken med 27 punkter som pekar på viktiga positioner för ansiktsdelar. För att returnera detta måste parametern returnFaceLandmarks vara true.
faceRectangle	FaceRectangle	Ett rektangelområde för ansiktsplatsen på bilden.
recognitionModel	RecognitionModel	"recognitionModel" som är associerad med detta faceId. Detta returneras endast när "returnRecognitionModel" uttryckligen anges som true.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på 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 ansiktsmärken med 27 punkter som pekar på ansiktskomponenternas viktiga positioner.

Name	Typ	Description
eyeLeftBottom	LandmarkCoordinate	Koordinaterna för vänster öga nederkant.
eyeLeftInner	LandmarkCoordinate	Koordinaterna för vänster öga 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 det högra ögats nedre del.
eyeRightInner	LandmarkCoordinate	Koordinaterna för det högra ögats 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 är yttre.
eyebrowRightInner	LandmarkCoordinate	Koordinaterna för det högra ögonbrynet inre.
eyebrowRightOuter	LandmarkCoordinate	Koordinaterna för det högra ögonbrynet yttre.
mouthLeft	LandmarkCoordinate	Koordinaterna för munnen till vänster.
mouthRight	LandmarkCoordinate	Koordinaterna för munnen till höger.
noseLeftAlarOutTip	LandmarkCoordinate	Näskoordinaterna lämnade alar ut spets.
noseLeftAlarTop	LandmarkCoordinate	Näskoordinaterna lämnade alar överst.
noseRightAlarOutTip	LandmarkCoordinate	Näskoordinaterna höger alar ut spets.
noseRightAlarTop	LandmarkCoordinate	Näskoordinaterna höger alar överst.
noseRootLeft	LandmarkCoordinate	Koordinaterna för nosroten till vänster.
noseRootRight	LandmarkCoordinate	Koordinaterna för nosroten höger.
noseTip	LandmarkCoordinate	Koordinaterna för nässpetsen.
pupilLeft	LandmarkCoordinate	Koordinaterna för vänster ögonelev.
pupilRight	LandmarkCoordinate	Koordinaterna för den högra ögoneleven.
underLipBottom	LandmarkCoordinate	Koordinaterna för underläppen.
underLipTop	LandmarkCoordinate	Koordinaterna för underläppen.
upperLipBottom	LandmarkCoordinate	Koordinaterna för överläppens underdel.
upperLipTop	LandmarkCoordinate	Koordinaterna för överläppens topp.

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 vänsterkanten om bilden till vänsterkanten i 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	Simmade skyddsglasögon i ansiktet.

HairColor

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

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	Brown.
gray	string	Grå.
other	string	Annat.
red	string	Röda.
unknown	string	Okänt.
white	string	Vit.

HairProperties

Egenskaper som beskriver hårattribut.

Name	Typ	Description
bald	number	Ett tal som beskriver konfidensnivån för huruvida personen är skallig.
hairColor	HairColor[]	En matris med kandidatfärger och konfidensnivå i närvaro av varje.
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 på ett visst ansikte.

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

MaskType

Typ av mask.

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 bildens brusnivå.

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 ögon är occluded.
foreheadOccluded	boolean	Ett booleskt värde som anger om pannan är occluded.
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 i mars 2019.
recognition_03	string	Igenkänningsmodellen släpptes i maj 2020.
recognition_04	string	Igenkänningsmodellen släpptes i februari 2021. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsprecision.

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