Face Detection Operations - Detect

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: v1.1-preview.1

Emberi arcok észlelése egy képen, arc téglalapok visszaadása, valamint opcionálisan faceId-ekkel, tereptárgyakkal és attribútumokkal.

Fontos

Annak érdekében, hogy mérsékeljük azokat a lehetséges visszaéléseket, amelyek a felhasználókat sztereotípiákhoz, diszkriminációhoz vagy tisztességtelen szolgáltatásmegtagadáshoz vezethetnek, megszűnnek a Face API-attribútumok, amelyek érzelmeket, nemet, kort, mosolyt, arcszőrzetet, hajat és sminket jeleznek előre. További információ erről a döntésről https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- A rendszer nem tárol lemezképet. Csak a kinyert arcfunkció(ka)t tárolja a rendszer 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.
- A választható paraméterek közé tartoznak 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 occlusion, a tartozékok, az életleníté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 túl pontos.
- A JPEG, a PNG, a GIF (az első képkocka) és a BMP formátum támogatott. Az engedélyezett képfájlméret 1 KB és 6 MB között van.
- A minimálisan észlelhető arcméret 36x36 képpont a képen, amely nem nagyobb, mint 1920x1080 képpont. A 1920x1080 képpontnál nagyobb méretű képekhez arányosan nagyobb minimális arcméretre lesz szükség.
- 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 a következők: előlapi, világos és minimálisan 200x200 képpont méretűek (szemenként 100 képpont).
- Különböző "detectionModel" értékek adhatók meg. A különböző észlelési modellek használatához és összehasonlításához tekintse meg a következőt: https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - "detection_02": Az arcattribútumok és a tájékozódási pontok le vannak tiltva, ha ezt az észlelési modellt választja.
  - "detection_03": Az arcattribútumok (maszk, életlenítés és headPose) és a tereptárgyak támogatottak, ha ezt az észlelési modellt választja.
- 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 a "recognitionModel" paraméterrel. A recognitionModel alapértelmezett értéke "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a szükséges modellt ebben a paraméterben. A megadott azonosító 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 a következőt: https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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".
faceIdTimeToLive	query		integer int32	A gyorsítótárazott arcazonosító másodperces 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" esetében javult.
returnFaceAttributes	query		FaceAttributeType[]	Elemezze és adja vissza a vesszővel tagolt sztring egy vagy több megadott arcattribútumát, például a "returnFaceAttributes=headPose,szemüveg" karakterláncot. 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. Az alapértelmezett érték az igaz.
returnFaceLandmarks	query		boolean	Az észlelt arcok arcjeleneteit adja vissza, vagy sem. Az alapértelmezett érték a hamis.
returnRecognitionModel	query		boolean	A "recognitionModel" értéket adja vissza, vagy sem. Az alapértelmezett érték a hamis. Ez csak akkor alkalmazható, ha returnFaceId = true.

Kérelem törzse

Media Types: "application/octet-stream"

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

Válaszok

Name	Típus	Description
200 OK	FaceDetectionResult[]	A sikeres hívás arcbejegyzések tömböt ad vissza, amely az arc téglalapmérete szerint csökkenő sorrendben van rangsorolva. 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 arcbejegyzések tömböt ad vissza, amely az arc téglalapmérete szerint csökkenő sorrendben van rangsorolva. 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-folyamat

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

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	Kiegészítő elem és a megfelelő megbízhatósági szint.
AccessoryType	A tartozék típusa.
BlurLevel	A homályosság szintjét jelzi.
BlurProperties	A képen belüli elmosódást leíró tulajdonságok.
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".
ExposureLevel	Az expozíció szintjét jelzi.
ExposureProperties	A kép expozíciós szintjét leíró tulajdonságok.
FaceAttributes	Az észlelt arc arcattribútumai.
FaceAttributeType	Elemezze és adja vissza a vesszővel tagolt sztring egy vagy több megadott arcattribútumát, például a "returnFaceAttributes=headPose,szemüveg" karakterláncot. 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	A hiba részleteit 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	Arcszőrzet-attribútumokat leíró tulajdonságok.
GlassesType	Az arc szemüvegtípusa.
HairColor	A jelölt színek és megbízhatósági szint tömbje az egyes színek jelenlétében.
HairColorType	A hajszín neve.
HairProperties	A hajattribútumokat leíró tulajdonságok.
HeadPose	Térhatású tekercs/yaw/pitch szögek az arc irányához.
LandmarkCoordinate	A képen belüli tájékozódási koordináták.
MaskProperties	A maszk adott arcon való jelenlétét leíró tulajdonságok.
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 az elzáródásokat leíró tulajdonságok.
QualityForRecognition	A képminőséget jelzi a felismeréshez.
RecognitionModel	Az arc felismerési modellje.

AccessoryItem

Kiegészítő elem és a megfelelő megbízhatósági szint.

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

AccessoryType

A tartozék típusa.

Name	Típus	Description
glasses	string	Szemüveg.
headwear	string	Fejkopás.
mask	string	Maszk.

BlurLevel

A homályosság szintjét jelzi.

Name	Típus	Description
high	string	Magas életlenítési szint.
low	string	Alacsony életlenítési szint.
medium	string	Közepes életlenítési szint.

BlurProperties

A képen belüli elmosódást leíró tulajdonságok.

Name	Típus	Description
blurLevel	BlurLevel	Egy számérték, amely a homályosság szintjét jelzi.
value	number	A 0 és 1 közötti elmosódottságot jelző szám.

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

Name	Típus	Description
detection_01	string	Az alapértelmezett észlelési modell. Javasoljuk, hogy közel előtérbeli arcfelismeréshez. 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	string	A 2019 májusában kiadott észlelési modell nagyobb pontosságot eredményez, különösen a kis, oldalsó és homályos arcokon.
detection_03	string	A 2021 februárjában kiadott észlelési modell nagyobb pontosságot eredményez, különösen a kis arcokon.

ExposureLevel

Az expozíció szintjét jelzi.

Name	Típus	Description
goodExposure	string	Jó expozíciós szint.
overExposure	string	Magas expozíciós szint.
underExposure	string	Alacsony expozíciós szint.

ExposureProperties

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

Az észlelt arc arcattribútumai.

Name	Típus	Description
accessories	AccessoryItem[]	Tulajdonságok, amelyek egy adott arcon lévő tartozékokat írják le.
age	number	Életkor évek alatt.
blur	BlurProperties	A képen belüli elmosódást leíró tulajdonságok.
exposure	ExposureProperties	A kép expozíciós szintjét leíró tulajdonságok.
facialHair	FacialHair	Arcszőrzet-attribútumokat leíró tulajdonságok.
glasses	GlassesType	Szemüveg típus, ha bármelyik arc.
hair	HairProperties	A hajattribútumokat leíró tulajdonságok.
headPose	HeadPose	Térhatású tekercs/yaw/pitch szögek az arc irányához.
mask	MaskProperties	A maszk adott arcon való jelenlétét leíró tulajdonságok.
noise	NoiseProperties	A kép zajszintét leíró tulajdonságok.
occlusion	OcclusionProperties	Az adott arcon az elzáródásokat leíró tulajdonságok.
qualityForRecognition	QualityForRecognition	Az általános képminőséget leíró tulajdonságok arra vonatkozóan, hogy az észlelés során használt kép megfelelő minőségű-e az arcfelismerési kísérlethez.
smile	number	Mosoly intenzitása, [0,1] közötti szám.

FaceAttributeType

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

Name	Típus	Description
accessories	string	Kiegészítők 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 nagyméretű maszk nem eredményezhet arcfelismerést.
age	string	Életkor évek alatt.
blur	string	Az arc elmosódott vagy sem. A Szint az "Alacsony", a "Közepes" vagy a "Magas" értéket adja vissza. Az érték [0,1] közötti számot ad vissza, minél nagyobb a homályosabb érték.
exposure	string	Arc expozíciós szintje. A Szint a "GoodExposure", "OverExposure" vagy "UnderExposure" értéket adja vissza.
facialHair	string	Arcszőrzet-attribútumokat leíró tulajdonságok.
glasses	string	Szemüveg típus. Az értékek közé tartozik a "NoGlasses", "ReadingGlasses", "Sunglasses", "SwimmingGoggles".
hair	string	A hajattribútumokat leíró tulajdonságok.
headPose	string	Térhatású tekercs/yaw/pitch szögek az arc irányához.
mask	string	Hogy minden arc visel-e maszkot. A maszk típusa "noMask", "faceMask", "otherMaskOrOcclusion" vagy "bizonytalan" értéket ad vissza. Az érték egy logikai "noseAndMouthCovered" értéket ad vissza, amely azt jelzi, hogy az orr és a száj lefedve van-e.
noise	string	Az arc képpontjainak zajszintje. A Szint az "Alacsony", a "Közepes" és a "Magas" értéket adja vissza. Az érték egy [0,1] közötti számot ad vissza, minél nagyobb a zajosabb
occlusion	string	Hogy minden arcterület el van-e csukva, beleértve a homlokot, a szemet és a szájat.
qualityForRecognition	string	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. Személyregisztrációhoz csak "kiváló" minőségű képek használata ajánlott, azonosítási forgatókönyvek esetén pedig a "közepes" vagy annál magasabb minőség ajánlott. Az attribútum csak recognition_03 vagy recognition_04 felismerési modellek használatakor érhető el.
smile	string	Mosoly intenzitása, [0,1] közötti szám.

FaceDetectionResult

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

Name	Típus	Description
faceAttributes	FaceAttributes	Arcattribútumok az észlelt archoz.
faceId	string	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 pontbó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épen látható arc helyének téglalap területe.
recognitionModel	RecognitionModel	A faceId azonosítóhoz társított "recognitionModel". Ez csak akkor lesz visszaadva, ha a "returnRecognitionModel" explicit módon igaz értékre van állítva.

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.

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

FaceErrorResponse

A hiba részleteit tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

FaceLandmarks

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 külső koordinátái.
eyeRightTop	LandmarkCoordinate	A jobb felső szem koordinátái.
eyebrowLeftInner	LandmarkCoordinate	A bal szemöldök belső 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áta-koordinátái kicsúsztak.
noseLeftAlarTop	LandmarkCoordinate	Az orr bal felső részének koordinátái.
noseRightAlarOutTip	LandmarkCoordinate	Az orr jobb oldali csúcsának koordinátái.
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 orrhegy koordinátái.
pupilLeft	LandmarkCoordinate	A bal szem tanulójának 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 ajakfelső koordinátái.
upperLipBottom	LandmarkCoordinate	A felső ajak aljának koordinátái.
upperLipTop	LandmarkCoordinate	A felső ajakfelső koordinátái.

FaceRectangle

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

Name	Típus	Description
height	integer	A téglalap magassága képpontban.
left	integer	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	A felső széltől mért távolság, ha a kép a téglalap felső széléig, képpontban kifejezve.
width	integer	A téglalap szélessége képpontban.

FacialHair

Arcszőrzet-attribútumokat leíró tulajdonságok.

Name	Típus	Description
beard	number	Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között.
moustache	number	Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között.
sideburns	number	Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között.

GlassesType

Az arc szemüvegtípusa.

Name	Típus	Description
noGlasses	string	Nincs szemüveg az arcon.
readingGlasses	string	Normál szemüveg az arcon.
sunglasses	string	Napszemüveg az arcon.
swimmingGoggles	string	Úszószemüveg az arcon.

HairColor

A jelölt színek és 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	A szín megbízhatósági szintje. [0,1] közötti tartomány.

HairColorType

A hajszín neve.

Name	Típus	Description
black	string	Fekete.
blond	string	Szőke.
brown	string	Barna.
gray	string	Szürke.
other	string	Egyéb.
red	string	Piros.
unknown	string	Unknown.
white	string	Fehér.

HairProperties

A hajattribútumokat leíró tulajdonságok.

Name	Típus	Description
bald	number	A megbízhatósági szintet leíró szám, amely azt jelzi, hogy a személy kopasz-e.
hairColor	HairColor[]	A jelölt színek és 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

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

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

LandmarkCoordinate

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

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

MaskProperties

A maszk adott arcon való jelenlétét leíró tulajdonságok.

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

A maszk típusa.

Name	Típus	Description
faceMask	string	Arcmaszk.
noMask	string	Nincs maszk.
otherMaskOrOcclusion	string	Más típusú maszkok és elzáródások.
uncertain	string	Bizonytalan.

NoiseLevel

A zaj szintjét jelzi.

Name	Típus	Description
high	string	Magas zajszint.
low	string	Alacsony zajszint.
medium	string	Közepes zajszint.

NoiseProperties

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

Name	Típus	Description
noiseLevel	NoiseLevel	Egy számérték, amely a zaj szintjét jelzi.
value	number	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

Az adott arcon az 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 el van-e zárt állapotban.
mouthOccluded	boolean	Logikai érték, amely azt jelzi, hogy a száj el van-e csukva.

QualityForRecognition

A képminőséget jelzi a felismeréshez.

Name	Típus	Description
high	string	Kiváló minőség.
low	string	Gyenge minőség.
medium	string	Közepes minőség.

RecognitionModel

Az arc felismerési modellje.

Name	Típus	Description
recognition_01	string	A "Detect" alapértelmezett felismerési modellje. A 2019 márciusa előtt létrehozott faceId azonosítók mindegyike ehhez a felismerési modellhez van kötve.
recognition_02	string	A felismerési modell 2019 márciusában jelent meg.
recognition_03	string	A felismerési modell 2020 májusában jelent meg.
recognition_04	string	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

További források