Face - Detect With Url

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: 1.0

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.

A rendszerkép nem lesz tárolva. A rendszer csak a kinyert arc funkciót tárolja a kiszolgálón. A faceId az arc funkció azonosítója, és a Face – Azonosítás, Arc – Ellenőrzés és Arc – Hasonló keresés funkcióban 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. Attribútumok közé tartozik az életkor, nem, headPose, mosoly, arcHair, szemüveg, érzelem, haj, smink, occlusion, kiegészítők, elmosódás, expozíció, zaj, maszk, és minőségiForRecognition. 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.
Egy képhez legfeljebb 100 arc adható vissza. Az arcok a nagytól a kicsiig az arc téglalapmérete szerint vannak rangsorolva.
Az Arc – Azonosítás, Arc – Ellenőrzés és Arc – Hasonló keresése (a "returnFaceId" igaz) lekérdezés optimális eredményéhez használjon olyan arcokat, amelyek a következők: előtér, átlátszó és minimális mérete 200x200 képpont (100 képpont a szem között).
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.
Különböző "detectionModel" értékeket lehet megadni. A különböző észlelési modellek használatához és összehasonlításához tekintse meg Az észlelési modell megadásacímű témakört.
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 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 a Felismerési modell megadása című témakört.

POST {Endpoint}/face/v1.0/detect

Opcionális paraméterekkel:

POST {Endpoint}/face/v1.0/detect?returnFaceId={returnFaceId}&returnFaceLandmarks={returnFaceLandmarks}&returnFaceAttributes={returnFaceAttributes}&recognitionModel={recognitionModel}&returnRecognitionModel={returnRecognitionModel}&detectionModel={detectionModel}&faceIdTimeToLive={faceIdTimeToLive}

URI-paraméterek

Name	In	Kötelező	Típus	Description
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com).
detectionModel	query		DetectionModel	Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect or (Large)FaceList – Add Face or (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet során. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.
faceIdTimeToLive	query		integer minimum: 60 maximum: 86400	A gyorsítótárazott faceId 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	A felismerési modell neve. A felismerési modell az arcfunkciók kinyerésekor és az észlelt faceId-ekhez, a (Nagy)FaceListhez vagy a (Nagy)PersonGrouphoz való társításakor használatos. A face – Detect or (Large)FaceList – Create vagy (Large)PersonGroup – Create (Nagy)PersonGroup – Létrehozás funkció végrehajtásakor megadható egy felismerési modell neve. Az alapértelmezett érték a "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a kívánt modellt.
returnFaceAttributes	query		FaceAttributeType[]	Elemezze és adja vissza az egy vagy több megadott arcattribútumot a vesszővel elválasztott sztringben, például "returnFaceAttributes=age,gender". Az elérhető attribútumok a megadott "detectionModel" függvénytől függnek. A "detection_01" támogatja az életkort, a nemet, a headPose-t, a mosolyt, az arcszőrzetet, a szemüveget, az érzelmet, a hajat, a sminket, az elzáródást, a kiegészítőket, az elmosódást, az expozíciót, a zajt és a minőségiForRecognition-t. Bár a "detection_02" nem támogat semmilyen attribútumot, és a "detection_03" csak a maszkot és a qualityForRecognition-t támogatja. Emellett a qualityForRecognition csak akkor támogatott, ha a "recognitionModel" kifejezés "recognition_03" vagy "recognition_04" néven van megadva. Vegye figyelembe, hogy minden arcattribútum-elemzés további számítási és időköltséggel rendelkezik.
returnFaceId	query		boolean	Érték, amely azt jelzi, hogy a műveletnek az észlelt arcok faceId azonosítóit kell-e visszaadnia. Ha ezt az értéket igaz értékre állítja, további hozzáférés-jóváhagyást igényel a következő helyen https://aka.ms/facerecognition: .
returnFaceLandmarks	query		boolean	Érték, amely azt jelzi, hogy a műveletnek vissza kell-e adnia az észlelt arcok nevezetességeit.
returnRecognitionModel	query		boolean	Egy érték, amely azt jelzi, hogy a művelet válaszként "recognitionModel" értéket ad-e vissza.

Kérelem fejléce

Name	Kötelező	Típus	Description
Ocp-Apim-Subscription-Key	True	string

Kérelem törzse

Name	Kötelező	Típus	Description
url	True	string	Kép nyilvánosan elérhető URL-címe

Válaszok

Name	Típus	Description
200 OK	DetectedFace[]	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	APIError	Hibaválasz.

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

Példák

Detect with url example

Mintakérelem

HTTP

POST {Endpoint}/face/v1.0/detect?returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise&recognitionModel=recognition_01&returnRecognitionModel=True&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Mintaválasz

Állapotkód:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_01",
    "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": {
      "age": 71,
      "gender": "male",
      "smile": 0.88,
      "facialHair": {
        "moustache": 0.8,
        "beard": 0.1,
        "sideburns": 0.02
      },
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "emotion": {
        "anger": 0.575,
        "contempt": 0,
        "disgust": 0.006,
        "fear": 0.008,
        "happiness": 0.394,
        "neutral": 0.013,
        "sadness": 0,
        "surprise": 0.004
      },
      "hair": {
        "bald": 0,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 1
          },
          {
            "color": "blond",
            "confidence": 0.88
          },
          {
            "color": "black",
            "confidence": 0.48
          },
          {
            "color": "other",
            "confidence": 0.11
          },
          {
            "color": "gray",
            "confidence": 0.07
          },
          {
            "color": "red",
            "confidence": 0.03
          }
        ]
      },
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": false
      },
      "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
      }
    }
  }
]

Definíciók

Name	Description
Accessory	Tartozékelem és a megfelelő megbízhatósági szint.
AccessoryType	A tartozék típusa
APIError	Az API által visszaadott hibainformációk
Blur	Az elmosódás jelenlétét leíró tulajdonságok a képen.
BlurLevel	A homályosság szintjét jelző számérték.
Coordinate	Koordináták egy képen belül
DetectedFace	Észlelt Face objektum.
DetectionModel	Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect or (Large)FaceList – Add Face or (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet során. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.
Emotion	Az arc érzelmeket 0 és 1 közötti megbízhatósági formában leíró tulajdonságok.
Error	Hibatörzs.
Exposure	A kép expozíciós szintjét leíró tulajdonságok.
ExposureLevel	Az expozíció szintjét jelző enumerálási érték.
FaceAttributes	Arcattribútumok
FaceAttributeType	Elemezze és adja vissza az egy vagy több megadott arcattribútumot a vesszővel elválasztott sztringben, például "returnFaceAttributes=age,gender". Az elérhető attribútumok a megadott "detectionModel" függvénytől függnek. A "detection_01" támogatja az életkort, a nemet, a headPose-t, a mosolyt, az arcszőrzetet, a szemüveget, az érzelmet, a hajat, a sminket, az elzáródást, a kiegészítőket, az elmosódást, az expozíciót, a zajt és a minőségiForRecognition-t. Bár a "detection_02" nem támogat semmilyen attribútumot, és a "detection_03" csak a maszkot és a qualityForRecognition-t támogatja. Emellett a qualityForRecognition csak akkor támogatott, ha a "recognitionModel" kifejezés "recognition_03" vagy "recognition_04" néven van megadva. Vegye figyelembe, hogy minden arcattribútum-elemzés további számítási és időköltséggel rendelkezik.
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.
Gender	Az arc lehetséges neme.
GlassesType	Szemüvegtípus, ha az arc bármelyike.
Hair	A hajat jellemző tulajdonságok.
HairColor	Hajszín és a hozzá tartozó megbízhatóság
HairColorType	A hajszín neve.
HeadPose	Az arc fejpózát jelző tulajdonságok.
ImageUrl
Makeup	Tulajdonságok, amelyek a smink jelenlétét írják le egy adott arcon.
Mask	Tulajdonságok, amelyek egy maszk jelenlétét írják le egy adott arcon.
MaskType	Maszk típusa, ha az arc bármelyike
Noise	A kép zajszintét leíró tulajdonságok.
NoiseLevel	A zajszintet jelző számérték.
Occlusion	Az adott arcon lévő elzáródásokat leíró tulajdonságok.
QualityForRecognition	Egy számérték, amely a kép minőségét jelzi a felismeréshez.
RecognitionModel	A felismerési modell neve. A felismerési modell az arcfunkciók kinyerésekor és az észlelt faceId-ekhez, a (Nagy)FaceListhez vagy a (Nagy)PersonGrouphoz való társításakor használatos. A face – Detect or (Large)FaceList – Create vagy (Large)PersonGroup – Create (Nagy)PersonGroup – Létrehozás funkció végrehajtásakor megadható egy felismerési modell neve. Az alapértelmezett érték a "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a kívánt modellt.

Accessory

Objektum

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

Name	Típus	Description
confidence	number minimum: 0 maximum: 1	A tartozék megbízhatósági szintje
type	AccessoryType	A tartozék típusa

AccessoryType

Enumerálás

A tartozék típusa

Érték	Description
glasses
headWear
mask

APIError

Objektum

Az API által visszaadott hibainformációk

Name	Típus	Description
error	Error	Hibatörzs.

Blur

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 minimum: 0 maximum: 1	A 0 és 1 közötti elmosódottságot jelző szám.

BlurLevel

Enumerálás

A homályosság szintjét jelző számérték.

Érték	Description
High
Low
Medium

Coordinate

Objektum

Koordináták egy képen belül

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

DetectedFace

Objektum

Észlelt Face objektum.

Name	Típus	Alapértelmezett érték	Description
faceAttributes	FaceAttributes		Arcattribútumok
faceId	string (uuid)
faceLandmarks	FaceLandmarks		27 pontos arc-tájékozódási pontok gyűjteménye, amely az arcösszetevők fontos pozícióira mutat.
faceRectangle	FaceRectangle		Egy téglalap, amelyen belül egy arc található
recognitionModel	RecognitionModel	recognition_01	A felismerési modell neve. A felismerési modell az arcfunkciók kinyerésekor és az észlelt faceId-ekhez, a (Nagy)FaceListhez vagy a (Nagy)PersonGrouphoz való társításakor használatos. A face – Detect or (Large)FaceList – Create vagy (Large)PersonGroup – Create (Nagy)PersonGroup – Létrehozás funkció végrehajtásakor megadható egy felismerési modell neve. Az alapértelmezett érték a "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a kívánt modellt.

DetectionModel

Enumerálás

Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect or (Large)FaceList – Add Face or (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet során. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.

Érték	Description
detection_01
detection_02
detection_03

Emotion

Objektum

Az arc érzelmeket 0 és 1 közötti megbízhatósági formában leíró tulajdonságok.

Name	Típus	Description
anger	number 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.
contempt	number 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.
disgust	number 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.
fear	number 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.
happiness	number 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.
neutral	number 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.
sadness	number 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.
surprise	number 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.

Error

Objektum

Hibatörzs.

Name	Típus	Description
code	string
message	string

Exposure

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

ExposureLevel

Enumerálás

Az expozíció szintjét jelző enumerálási érték.

Érték	Description
GoodExposure
OverExposure
UnderExposure

FaceAttributes

Objektum

Arcattribútumok

Name	Típus	Description
accessories	Accessory[]	Tulajdonságok, amelyek egy adott arcon lévő tartozékokat írják le.
age	number	Életkor évek alatt
blur	Blur	Az elmosódás jelenlétét leíró tulajdonságok a képen.
emotion	Emotion	Az arc érzelmeket 0 és 1 közötti megbízhatósági formában leíró tulajdonságok.
exposure	Exposure	A kép expozíciós szintjét leíró tulajdonságok.
facialHair	FacialHair	Az arcszőrzet attribútumait leíró tulajdonságok.
gender	Gender	Az arc lehetséges neme.
glasses	GlassesType	Szemüvegtípus, ha az arc bármelyike.
hair	Hair	A hajat jellemző tulajdonságok.
headPose	HeadPose	Az arc fejpózát jelző tulajdonságok.
makeup	Makeup	Tulajdonságok, amelyek a smink jelenlétét írják le egy adott arcon.
mask	Mask	Tulajdonságok, amelyek egy maszk jelenlétét írják le egy adott arcon.
noise	Noise	A kép zajszintét leíró tulajdonságok.
occlusion	Occlusion	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 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 "returnFaceAttributes=age,gender". Az elérhető attribútumok a megadott "detectionModel" függvénytől függnek. A "detection_01" támogatja az életkort, a nemet, a headPose-t, a mosolyt, az arcszőrzetet, a szemüveget, az érzelmet, a hajat, a sminket, az elzáródást, a kiegészítőket, az elmosódást, az expozíciót, a zajt és a minőségiForRecognition-t. Bár a "detection_02" nem támogat semmilyen attribútumot, és a "detection_03" csak a maszkot és a qualityForRecognition-t támogatja. Emellett a qualityForRecognition csak akkor támogatott, ha a "recognitionModel" kifejezés "recognition_03" vagy "recognition_04" néven van megadva. Vegye figyelembe, hogy minden arcattribútum-elemzés további számítási és időköltséggel rendelkezik.

Érték	Description
accessories
age
blur
emotion
exposure
facialHair
gender
glasses
hair
headPose
makeup
mask
noise
occlusion
qualityForRecognition
smile

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	Coordinate	Koordináták egy képen belül
eyeLeftInner	Coordinate	Koordináták egy képen belül
eyeLeftOuter	Coordinate	Koordináták egy képen belül
eyeLeftTop	Coordinate	Koordináták egy képen belül
eyeRightBottom	Coordinate	Koordináták egy képen belül
eyeRightInner	Coordinate	Koordináták egy képen belül
eyeRightOuter	Coordinate	Koordináták egy képen belül
eyeRightTop	Coordinate	Koordináták egy képen belül
eyebrowLeftInner	Coordinate	Koordináták egy képen belül
eyebrowLeftOuter	Coordinate	Koordináták egy képen belül
eyebrowRightInner	Coordinate	Koordináták egy képen belül
eyebrowRightOuter	Coordinate	Koordináták egy képen belül
mouthLeft	Coordinate	Koordináták egy képen belül
mouthRight	Coordinate	Koordináták egy képen belül
noseLeftAlarOutTip	Coordinate	Koordináták egy képen belül
noseLeftAlarTop	Coordinate	Koordináták egy képen belül
noseRightAlarOutTip	Coordinate	Koordináták egy képen belül
noseRightAlarTop	Coordinate	Koordináták egy képen belül
noseRootLeft	Coordinate	Koordináták egy képen belül
noseRootRight	Coordinate	Koordináták egy képen belül
noseTip	Coordinate	Koordináták egy képen belül
pupilLeft	Coordinate	Koordináták egy képen belül
pupilRight	Coordinate	Koordináták egy képen belül
underLipBottom	Coordinate	Koordináták egy képen belül
underLipTop	Coordinate	Koordináták egy képen belül
upperLipBottom	Coordinate	Koordináták egy képen belül
upperLipTop	Coordinate	Koordináták egy képen belül

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

Gender

Enumerálás

Az arc lehetséges neme.

Érték	Description
female
male

GlassesType

Enumerálás

Szemüvegtípus, ha az arc bármelyike.

Érték	Description
noGlasses
readingGlasses
sunglasses
swimmingGoggles

Hair

Objektum

A hajat jellemző tulajdonságok.

Name	Típus	Description
bald	number 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.

HairColor

Objektum

Hajszín és a hozzá tartozó megbízhatóság

Name	Típus	Description
color	HairColorType	A hajszín neve.
confidence	number minimum: 0 maximum: 1	A szín megbízhatósági szintje

HairColorType

Enumerálás

A hajszín neve.

Érték	Description
black
blond
brown
gray
other
red
unknown
white

HeadPose

Objektum

Az arc fejpózát jelző tulajdonságok.

Name	Típus	Description
pitch	number
roll	number
yaw	number

ImageUrl

Objektum

Name	Típus	Description
url	string	Kép nyilvánosan elérhető URL-címe

Makeup

Objektum

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

Name	Típus	Description
eyeMakeup	boolean	Logikai érték, amely leírja, hogy a szem sminkje jelen van-e az arcon.
lipMakeup	boolean	Logikai érték, amely leírja, hogy az ajak sminkje jelen van-e az arcon.

Mask

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	Maszk típusa, ha az arc bármelyike

MaskType

Enumerálás

Maszk típusa, ha az arc bármelyike

Érték	Description
faceMask
noMask
otherMaskOrOcclusion
uncertain

Noise

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

NoiseLevel

Enumerálás

A zajszintet jelző számérték.

Érték	Description
High
Low
Medium

Occlusion

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

Egy számérték, amely a kép minőségét jelzi a felismeréshez.

Érték	Description
High
Low
Medium

RecognitionModel

Enumerálás

A felismerési modell neve. A felismerési modell az arcfunkciók kinyerésekor és az észlelt faceId-ekhez, a (Nagy)FaceListhez vagy a (Nagy)PersonGrouphoz való társításakor használatos. A face – Detect or (Large)FaceList – Create vagy (Large)PersonGroup – Create (Nagy)PersonGroup – Létrehozás funkció végrehajtásakor megadható egy felismerési modell neve. Az alapértelmezett érték a "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a kívánt modellt.

Érték	Description
recognition_01
recognition_02
recognition_03
recognition_04

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

Face - Detect With Url

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Biztonság

Ocp-Apim-Subscription-Key

Példák

Detect with url example

Mintakérelem

Mintaválasz

Definíciók

Accessory

AccessoryType

APIError

Blur

BlurLevel

Coordinate

DetectedFace

DetectionModel

Emotion

Error

Exposure

ExposureLevel

FaceAttributes

FaceAttributeType

FaceLandmarks

FaceRectangle

FacialHair

Gender

GlassesType

Hair

HairColor

HairColorType

HeadPose

ImageUrl

Makeup

Mask

MaskType

Noise

NoiseLevel

Occlusion

QualityForRecognition

RecognitionModel