Face Detection Operations - Detect

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: v1.2

Emberi arcok észlelése egy képen, arc téglalapok visszaadása, és igény szerint faceId-ekkel, tájékozódási pontokkal és attribútumokkal.

Fontos

A Microsoft kivezetett vagy korlátozott arcfelismerő képességekkel rendelkezik, amelyekkel olyan érzelmi állapotokat és identitástulajdonságokat próbálhat kikövetkeztetni, amelyek visszaélve sztereotipizálást, megkülönböztetést vagy szolgáltatásmegtagadást okozhatnak. A kivezetett képességek érzelmek és nemek. A korlátozott képességek az életkor, a mosoly, az arcszőrzet, a haj és a smink. E-mailben Azure Face API-, ha olyan felelősségteljes használati esete van, amely a korlátozott képességek bármelyikének előnyeit élvezné. További információ erről a döntésről itt.

- A rendszerkép nem lesz tárolva. A rendszer csak a kinyert arcfunkció(ka)t tárolja a kiszolgálón. A faceId az arcfunkció azonosítója, és az "Azonosítás", az "Ellenőrzés" és a "Hasonló keresése" kifejezésben lesz használva. A tárolt arcfunkciók lejárnak, és az eredeti észlelési hívás után a faceIdTimeToLive által megadott időpontban törlődnek.
- Az opcionális paraméterek közé tartozik a faceId, a tájékozódási pontok és az attribútumok. Az attribútumok közé tartozik a headPose, a szemüveg, az elzáródás, a tartozékok, az elmosódás, az expozíció, a zaj, a maszk és a qualityForRecognition. Előfordulhat, hogy bizonyos attribútumok esetében visszaadott eredmények némelyike nem feltétlenül pontos.
- A JPEG, a PNG, a GIF (az első képkocka) és a BMP formátum támogatott. Az engedélyezett képfájl mérete 1KB és 6 MB között van.
- A minimálisan észlelhető arcméret 36x36 képpont egy 1920x1080 képpontnál nem nagyobb képben. Az 1920x1080 képpontnál nagyobb méretű képeknek arányosan nagyobb minimális arcméretre lesz szükségük.
- Egy képhez legfeljebb 100 arc adható vissza. Az arcok a nagytól a kicsiig az arc téglalapmérete szerint vannak rangsorolva.
- Az "Azonosítás", az "Ellenőrzés" és a "Hasonló keresése" (a "returnFaceId" értéke igaz) lekérdezés optimális eredményéhez használjon olyan arcokat, amelyek: előtér, átlátszó és minimális mérete 200x200 képpont (100 képpont a szem között).
- Különböző "detectionModel" értékeket lehet megadni. A tájékozódási pontok és a támogatott attribútumok elérhetősége a megadott észlelési modelltől függ. A különböző észlelési modellek használatához és összehasonlításához tekintse meg itt.
- A rendszer különböző "recognitionModel" értékeket ad meg. Ha olyan követő műveletekre van szükség, mint az "Ellenőrzés", az "Azonosítás", a "Hasonló keresése", adja meg a felismerési modellt "recognitionModel" paraméterrel. A recognitionModel alapértelmezett értéke a "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a paraméterben szükséges modellt. A megadott érték megadása után az észlelt faceId-azonosítók a megadott felismerési modellhez lesznek társítva. További részletekért tekintse meg itt.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01". A "detection_03" használata ajánlott, mivel pontossága kisebb arcokon (64x64 képpont) és elforgatott arc tájoláson javul.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	A gyorsítótárazott arcazonosító másodperceinek száma. A támogatott tartomány 60 másodperctől 86400 másodpercig terjed. Az alapértelmezett érték 86400 (24 óra).
recognitionModel	query		RecognitionModel	Az észlelt faceId-ekhez társított "recognitionModel". A támogatott "recognitionModel" értékek a következők: "recognition_01", "recognition_02", "recognition_03" vagy "recognition_04". Az alapértelmezett érték a "recognition_01". A "recognition_04" használata ajánlott, mivel a maszkot viselő arcok pontossága a "recognition_03" és a "recognition_01" és a "recognition_02" értékhez képest javul.
returnFaceAttributes	query		FaceAttributeType[]	Elemezze és adja vissza az egy vagy több megadott arcattribútumot a vesszővel elválasztott sztringben, például a "returnFaceAttributes=headPose,szemüveg" sztringben. A Face attribútumelemzés további számítási és időköltséggel rendelkezik.
returnFaceId	query		boolean	Az észlelt arcok faceId azonosítóit adja vissza, vagy sem. Az alapértelmezett érték igaz.
returnFaceLandmarks	query		boolean	Adja vissza az észlelt arcok arcjelzőit, vagy sem. Az alapértelmezett érték hamis.
returnRecognitionModel	query		boolean	A "recognitionModel" értéket adja vissza, vagy sem. Az alapértelmezett érték hamis. Ez csak akkor alkalmazható, ha a returnFaceId = true értéket adja meg.

Kérelem törzse

Media Types: "application/octet-stream"

Name	Típus	Description
imageContent	string (binary)	A bemeneti kép bináris fájlja.

Válaszok

Name	Típus	Description
200 OK	FaceDetectionResult[]	A sikeres hívás az arcbejegyzések tömböt ad vissza, az arc téglalapmérete szerint csökkenő sorrendben. Az üres válasz azt jelzi, hogy nem észlelhető arc.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Name

Típus

Description

200 OK

FaceDetectionResult[]

A sikeres hívás az arcbejegyzések tömböt ad vissza, az arc téglalapmérete szerint csökkenő sorrendben. Az üres válasz azt jelzi, hogy nem észlelhető arc.

Other Status Codes

FaceErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Típus: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://api.example.com/oauth2/authorize
Jogkivonat URL-címe: https://api.example.com/oauth2/token

Hatókörök

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

Példák

Detect with Image

Mintakérelem

HTTP

POST {endpoint}/face/v1.2/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Mintaválasz

Állapotkód:: 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"
    }
  }
]

Definíciók

Name	Description
AccessoryItem	Tartozékelem és a megfelelő megbízhatósági szint.
AccessoryType	A tartozék típusa.
BlurLevel	A homályosság szintjét jelzi.
BlurProperties	Az elmosódás jelenlétét leíró tulajdonságok a képen.
DetectionModel	Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01". A "detection_03" használata ajánlott, mivel pontossága kisebb arcokon (64x64 képpont) és elforgatott arc tájoláson javul.
ExposureLevel	Az expozíció szintjét jelzi.
ExposureProperties	A kép expozíciós szintjét leíró tulajdonságok.
FaceAttributes	Arcattribútumok az észlelt archoz.
FaceAttributeType	Elemezze és adja vissza az egy vagy több megadott arcattribútumot a vesszővel elválasztott sztringben, például a "returnFaceAttributes=headPose,szemüveg" sztringben. A Face attribútumelemzés további számítási és időköltséggel rendelkezik.
FaceDetectionResult	Válasz az API észlelésére.
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hibaadatokat tartalmazó válasz.
FaceLandmarks	27 pontos arc-tájékozódási pontok gyűjteménye, amely az arcösszetevők fontos pozícióira mutat.
FaceRectangle	Egy téglalap, amelyen belül egy arc található.
FacialHair	Az arcszőrzet attribútumait leíró tulajdonságok.
GlassesType	Az arc szemüvege.
HairColor	A jelöltszínek és a megbízhatósági szint tömbje az egyes színek jelenlétében.
HairColorType	A hajszín neve.
HairProperties	A hajat jellemző tulajdonságok.
HeadPose	Térhatású roll/yaw/pitch szögek az arc irányához.
LandmarkCoordinate	A képen belüli tájékozódási koordináták.
MaskProperties	Tulajdonságok, amelyek egy maszk jelenlétét írják le egy adott arcon.
MaskType	A maszk típusa.
NoiseLevel	A zaj szintjét jelzi.
NoiseProperties	A kép zajszintét leíró tulajdonságok.
OcclusionProperties	Az adott arcon lévő elzáródásokat leíró tulajdonságok.
QualityForRecognition	A kép minőségét jelzi a felismeréshez.
RecognitionModel	Az arc felismerési modellje.

AccessoryItem

Objektum

Tartozékelem és a megfelelő megbízhatósági szint.

Name	Típus	Description
confidence	number (float) minimum: 0 maximum: 1	A tartozéktípus megbízhatósági szintje. [0,1] közötti tartomány.
type	AccessoryType	A tartozék típusa.

AccessoryType

Enumerálás

A tartozék típusa.

Érték	Description
glasses	Szemüveg.
headwear	Fejkopás.
mask	Maszk.

BlurLevel

Enumerálás

A homályosság szintjét jelzi.

Érték	Description
high	Magas elmosódási szint.
low	Alacsony elmosódási szint.
medium	Közepes elmosódási szint.

BlurProperties

Objektum

Az elmosódás jelenlétét leíró tulajdonságok a képen.

Name	Típus	Description
blurLevel	BlurLevel	A homályosság szintjét jelző számérték.
value	number (float) minimum: 0 maximum: 1	A 0 és 1 közötti elmosódottságot jelző szám.

DetectionModel

Enumerálás

Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01". A "detection_03" használata ajánlott, mivel pontossága kisebb arcokon (64x64 képpont) és elforgatott arc tájoláson javul.

Érték	Description
detection_01	Az alapértelmezett észlelési modell. A közel frontális arcfelismeréshez ajánlott. Kivételesen nagy szögű (fej-póz) arcokkal, elzárt arcokkal vagy rossz kép tájolással rendelkező forgatókönyvek esetén előfordulhat, hogy az ilyen esetekben az arcok nem észlelhetők.
detection_02	Az észlelési modell 2019 májusában jelent meg, nagyobb pontossággal, különösen a kis, oldalsó és homályos arcokon.
detection_03	Az észlelési modell 2021 februárjában jelent meg, nagyobb pontossággal, különösen a kis arcokon.

ExposureLevel

Enumerálás

Az expozíció szintjét jelzi.

Érték	Description
goodExposure	Jó expozíciós szint.
overExposure	Magas expozíciós szint.
underExposure	Alacsony expozíciós szint.

ExposureProperties

Objektum

A kép expozíciós szintjét leíró tulajdonságok.

Name	Típus	Description
exposureLevel	ExposureLevel	Az expozíció szintjét jelző enumerálási érték.
value	number (float) minimum: 0 maximum: 1	0 és 1 közötti expozíciós szintet jelző szám. [0, 0,25) expozíció alatt áll. [0,25, 0,75) jó expozíció. [0,75, 1] túl van téve az expozíciónak.

FaceAttributes

Objektum

Arcattribútumok az észlelt archoz.

Name	Típus	Description
accessories	AccessoryItem[]	Tulajdonságok, amelyek egy adott arcon lévő tartozékokat írják le.
age	number (float)	Életkor évek alatt.
blur	BlurProperties	Az elmosódás jelenlétét leíró tulajdonságok a képen.
exposure	ExposureProperties	A kép expozíciós szintjét leíró tulajdonságok.
facialHair	FacialHair	Az arcszőrzet attribútumait leíró tulajdonságok.
glasses	GlassesType	Szemüvegtípus, ha az arc bármelyike.
hair	HairProperties	A hajat jellemző tulajdonságok.
headPose	HeadPose	Térhatású roll/yaw/pitch szögek az arc irányához.
mask	MaskProperties	Tulajdonságok, amelyek egy maszk jelenlétét írják le egy adott arcon.
noise	NoiseProperties	A kép zajszintét leíró tulajdonságok.
occlusion	OcclusionProperties	Az adott arcon lévő elzáródásokat leíró tulajdonságok.
qualityForRecognition	QualityForRecognition	Az általános képminőséget leíró tulajdonságok, amelyek azt írják le, hogy az észlelés során használt kép megfelelő minőségű-e az arcfelismerési kísérlethez.
smile	number (float) minimum: 0 maximum: 1	Mosoly intenzitása, egy szám között [0,1].

FaceAttributeType

Enumerálás

Elemezze és adja vissza az egy vagy több megadott arcattribútumot a vesszővel elválasztott sztringben, például a "returnFaceAttributes=headPose,szemüveg" sztringben. A Face attribútumelemzés további számítási és időköltséggel rendelkezik.

Érték	Description
accessories	Tartozékok az arc körül, beleértve a "fejruhát", a "szemüveget" és a "maszkot". Az üres tömb azt jelenti, hogy a rendszer nem észlel tartozékokat. Vegye figyelembe, hogy ez az arc észlelése után történik. A nagy maszk miatt nem észlelhető arc.
age	Életkor évek alatt.
blur	Az arc homályos vagy sem. A szint "Low", "Medium" vagy "High" értéket ad vissza. Az érték [0,1] közötti számot ad vissza, minél nagyobb a homályosabb.
exposure	Arc expozíciós szintje. A szint a "GoodExposure", "OverExposure" vagy "UnderExposure" értéket adja vissza.
facialHair	Az arcszőrzet attribútumait leíró tulajdonságok.
glasses	Szemüveg típus. Az értékek közé tartozik a "NoGlasses", a "ReadingGlasses", a "Napszemüveg", a "SwimmingGoggles".
hair	A hajat jellemző tulajdonságok.
headPose	Térhatású roll/yaw/pitch szögek az arc irányához.
mask	Hogy minden arcon maszk van-e. A maszk típusa a "noMask", a "faceMask", az "otherMaskOrOcclusion" vagy a "bizonytalan" értéket adja vissza. Az érték egy logikai "orrAndMouthCovered" értéket ad vissza, amely azt jelzi, hogy az orr és a száj lefedve van-e.
noise	Az arc képpontjainak zajszintje. A szint az "Alacsony", a "Közepes" és a "Magas" értéket adja vissza. Az érték [0,1] közötti számot ad vissza, minél nagyobb a zajosabb
occlusion	Függetlenül attól, hogy minden arcterület el van-e zárt, beleértve a homlokot, a szemet és a szájat.
qualityForRecognition	Az általános képminőség azt illetően, hogy az észlelés során használt kép megfelelő minőségű-e az arcfelismerési kísérlethez. Az érték alacsony, közepes vagy magas nem hivatalos minősítés. Azonosítási forgatókönyvek esetében csak a "magas" minőségű képek használata ajánlott a személyregisztrációhoz, a minőség pedig a "közepes" vagy annál magasabb szinten. Az attribútum csak recognition_03 vagy recognition_04 felismerési modellek használatakor érhető el.
smile	Mosoly intenzitása, egy szám között [0,1].

FaceDetectionResult

Objektum

Válasz az API észlelésére.

Name	Típus	Description
faceAttributes	FaceAttributes	Arcattribútumok az észlelt archoz.
faceId	string (uuid)	Az észlelt arc egyedi faceId azonosítója, amelyet az észlelési API hoz létre, és az észlelési hívás után 24 órával lejár. Ennek visszaadásához a "returnFaceId" paraméternek igaznak kell lennie.
faceLandmarks	FaceLandmarks	27 pontos arc-tájékozódási pontokból álló tömb, amely az arcösszetevők fontos pozícióira mutat. Ennek visszaadásához a "returnFaceLandmarks" paraméternek igaznak kell lennie.
faceRectangle	FaceRectangle	A kép archelyének téglalapterülete.
recognitionModel	RecognitionModel	A faceId azonosítóhoz társított "recognitionModel". Ez csak akkor lesz visszaadva, ha a "returnRecognitionModel" explicit módon igazként van beállítva.

FaceError

Objektum

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba ember által olvasható ábrázolása.

FaceErrorResponse

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

FaceLandmarks

Objektum

27 pontos arc-tájékozódási pontok gyűjteménye, amely az arcösszetevők fontos pozícióira mutat.

Name	Típus	Description
eyeLeftBottom	LandmarkCoordinate	A bal szem aljának koordinátái.
eyeLeftInner	LandmarkCoordinate	A bal szem belső koordinátái.
eyeLeftOuter	LandmarkCoordinate	A bal szem koordinátái.
eyeLeftTop	LandmarkCoordinate	A bal szem tetejének koordinátái.
eyeRightBottom	LandmarkCoordinate	A jobb szem aljának koordinátái.
eyeRightInner	LandmarkCoordinate	A jobb szem belső koordinátái.
eyeRightOuter	LandmarkCoordinate	A jobb szem koordinátái.
eyeRightTop	LandmarkCoordinate	A jobb szem tetejének koordinátái.
eyebrowLeftInner	LandmarkCoordinate	A bal szemöldök koordinátái.
eyebrowLeftOuter	LandmarkCoordinate	A bal szemöldök külső koordinátái.
eyebrowRightInner	LandmarkCoordinate	A jobb szemöldök belső koordinátái.
eyebrowRightOuter	LandmarkCoordinate	A jobb szemöldök külső koordinátái.
mouthLeft	LandmarkCoordinate	A száj koordinátái balra.
mouthRight	LandmarkCoordinate	A száj koordinátái jobbra.
noseLeftAlarOutTip	LandmarkCoordinate	Az orr koordinátái kicsúsztak.
noseLeftAlarTop	LandmarkCoordinate	Az orr koordinátái bal felső részén.
noseRightAlarOutTip	LandmarkCoordinate	Az orr jobb oldali koordinátái kicsúsznak.
noseRightAlarTop	LandmarkCoordinate	Az orr jobb felső részének koordinátái.
noseRootLeft	LandmarkCoordinate	Az orrgyökér koordinátái balra.
noseRootRight	LandmarkCoordinate	Az orrgyökér koordinátái jobbra.
noseTip	LandmarkCoordinate	Az orrcsúcs koordinátái.
pupilLeft	LandmarkCoordinate	A bal szem pupilla koordinátái.
pupilRight	LandmarkCoordinate	A jobb szem pupilláinak koordinátái.
underLipBottom	LandmarkCoordinate	A száj alsó részének koordinátái.
underLipTop	LandmarkCoordinate	Az ajak alatti felső koordináták.
upperLipBottom	LandmarkCoordinate	A felső ajak aljának koordinátái.
upperLipTop	LandmarkCoordinate	A felső ajak felső részének koordinátái.

FaceRectangle

Objektum

Egy téglalap, amelyen belül egy arc található.

Name	Típus	Description
height	integer (int32)	A téglalap magassága képpontban.
left	integer (int32)	A bal széltől mért távolság, ha a kép a téglalap bal szélétől képpontban van.
top	integer (int32)	A felső széltől való távolság, ha a kép a téglalap felső széle, képpontban.
width	integer (int32)	A téglalap szélessége képpontban.

FacialHair

Objektum

Az arcszőrzet attribútumait leíró tulajdonságok.

Name	Típus	Description
beard	number (float) minimum: 0 maximum: 1	0 és 1 közötti szám, amely egy tulajdonsághoz társított megbízhatósági szintet jelez.
moustache	number (float) minimum: 0 maximum: 1	0 és 1 közötti szám, amely egy tulajdonsághoz társított megbízhatósági szintet jelez.
sideburns	number (float) minimum: 0 maximum: 1	0 és 1 közötti szám, amely egy tulajdonsághoz társított megbízhatósági szintet jelez.

GlassesType

Enumerálás

Az arc szemüvege.

Érték	Description
noGlasses	Nincs szemüveg az arcon.
readingGlasses	Normál szemüveg az arcon.
sunglasses	Napszemüveg az arcon.
swimmingGoggles	Úszószemüveg az arcon.

HairColor

Objektum

A jelöltszínek és a megbízhatósági szint tömbje az egyes színek jelenlétében.

Name	Típus	Description
color	HairColorType	A hajszín neve.
confidence	number (float) minimum: 0 maximum: 1	A szín megbízhatósági szintje. [0,1] közötti tartomány.

HairColorType

Enumerálás

A hajszín neve.

Érték	Description
black	Fekete.
blond	Szőke.
brown	Barna.
gray	Szürke.
other	Más.
red	Piros.
unknown	Ismeretlen.
white	Fehér.

HairProperties

Objektum

A hajat jellemző tulajdonságok.

Name	Típus	Description
bald	number (float) minimum: 0 maximum: 1	A megbízhatósági szintet leíró szám, amely azt jelzi, hogy a személy kopasz-e.
hairColor	HairColor[]	A jelöltszínek és a megbízhatósági szint tömbje az egyes színek jelenlétében.
invisible	boolean	Logikai érték, amely leírja, hogy a haj látható-e a képen.

HeadPose

Objektum

Térhatású roll/yaw/pitch szögek az arc irányához.

Name	Típus	Description
pitch	number (float)	A szögek értéke.
roll	number (float)	A szögek értéke.
yaw	number (float)	A szögek értéke.

LandmarkCoordinate

Objektum

A képen belüli tájékozódási koordináták.

Name	Típus	Description
x	number (float)	A vízszintes összetevő képpontban.
y	number (float)	A függőleges összetevő képpontban.

MaskProperties

Objektum

Tulajdonságok, amelyek egy maszk jelenlétét írják le egy adott arcon.

Name	Típus	Description
noseAndMouthCovered	boolean	Logikai érték, amely azt jelzi, hogy az orr és a száj lefedve van-e.
type	MaskType	A maszk típusa.

MaskType

Enumerálás

A maszk típusa.

Érték	Description
faceMask	Arc maszk.
noMask	Nincs maszk.
otherMaskOrOcclusion	Más típusú maszkok vagy elzáródás.
uncertain	Bizonytalan.

NoiseLevel

Enumerálás

A zaj szintjét jelzi.

Érték	Description
high	Magas zajszint.
low	Alacsony zajszint.
medium	Közepes zajszint.

NoiseProperties

Objektum

A kép zajszintét leíró tulajdonságok.

Name	Típus	Description
noiseLevel	NoiseLevel	A zajszintet jelző számérték.
value	number (float) minimum: 0 maximum: 1	0 és 1 közötti zajszintet jelző szám. [0, 0,25) expozíció alatt áll. [0,25, 0,75) jó expozíció. [0,75, 1] túl van téve az expozíciónak. [0, 0,3) alacsony zajszint. [0.3, 0.7) közepes zajszint. [0,7, 1] magas zajszint.

OcclusionProperties

Objektum

Az adott arcon lévő elzáródásokat leíró tulajdonságok.

Name	Típus	Description
eyeOccluded	boolean	Logikai érték, amely azt jelzi, hogy a szemek el vannak-e zártak.
foreheadOccluded	boolean	Logikai érték, amely azt jelzi, hogy a homlok elzárva van-e.
mouthOccluded	boolean	Logikai érték, amely azt jelzi, hogy a száj elzárva van-e.

QualityForRecognition

Enumerálás

A kép minőségét jelzi a felismeréshez.

Érték	Description
high	Kiváló minőség.
low	Gyenge minőség.
medium	Közepes minőség.

RecognitionModel

Enumerálás

Az arc felismerési modellje.

Érték	Description
recognition_01	Az "Detect" alapértelmezett felismerési modellje. A 2019 márciusa előtt létrehozott faceId-eket ez a felismerési modell köti össze.
recognition_02	A 2019. márciusban kiadott felismerési modell.
recognition_03	Az elismerési modell 2020 májusában jelent meg.
recognition_04	A 2021 februárjában kiadott felismerési modell. Javasoljuk, hogy ezt a felismerési modellt használja a jobb felismerési pontosság érdekében.

Megosztás a következőn keresztül:

Face Detection Operations - Detect

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

Ocp-Apim-Subscription-Key

AADToken

Hatókörök

Példák

Detect with Image

Mintakérelem

Mintaválasz

Definíciók

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