Face Detection Operations - Detect

Reference

Služba:: Azure AI Services

Verze rozhraní API:: v1.2-preview.1

Rozpoznávání lidských tváří na obrázku, vrácení obdélníků tváře a volitelně s id tváře, orientačními body a atributy.

Důležitý

Společnost Microsoft vyřadila nebo omezila možnosti rozpoznávání obličeje, které se dají použít k odvozování emocionálních stavů a atributů identity, které mohou v případě zneužití podléhat stereotypům, diskriminaci nebo nespravedlivému odepření služeb. Vyřazené funkce jsou emoce a pohlaví. Omezené schopnosti jsou věk, úsměv, obličejové vlasy, vlasy a make-up. E-mailem azureface@microsoft.com rozhraní Api pro rozpoznávání tváře v Azure, pokud máte zodpovědný případ použití, který by pro vás mohl využívat některou z omezených možností. Přečtěte si další informace o tomto rozhodnutí https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Neuloží se žádná image. Na serveru budou uloženy pouze extrahované funkce tváře. FaceId je identifikátor funkce tváře a použije se v části Identifikace, Ověření a Najít podobné. Platnost uložených funkcí tváře vyprší a odstraní se v okamžiku určeném faceIdTimeToLive po původním volání detekce.
- Volitelné parametry zahrnují faceId, orientační body a atributy. Mezi atributy patří headPose, brýle, okluze, příslušenství, rozostření, expozice, šum, maska a kvalitaForRecognition. Některé výsledky vrácené pro konkrétní atributy nemusí být vysoce přesné.
- Podporuje se formát JPEG, PNG, GIF (první snímek) a BMP. Povolená velikost souboru obrázku je od 1 kB do 6 MB.
- Minimální zjistitelná velikost obličeje je 36 × 36 pixelů na obrázku, který není větší než 1920 × 1080 pixelů. Obrázky s rozměry vyššími než 1920 × 1080 pixelů budou potřebovat proporcionálně větší minimální velikost obličeje.
- Pro obrázek je možné vrátit až 100 tváří. Tváře jsou seřazené podle velikosti obdélníku tváře od velkých po malé.
- Pro optimální výsledky při dotazování "Identifikovat", "Ověřit" a "Najít podobné" ('returnFaceId' je true), použijte tváře, které jsou: frontální, jasné a s minimální velikostí 200 × 200 pixelů (100 pixelů mezi očima).
- Je možné zadat různé hodnoty detectionModel. Pokud chcete použít a porovnat různé modely detekce, projděte si https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': Atributy tváře a orientační body jsou zakázané, pokud zvolíte tento model detekce.
  - 'detection_03': Atributy tváře (maska, rozostření a headPose) a orientační body jsou podporovány, pokud zvolíte tento model detekce.
- Jsou k dispozici různé hodnoty recognitionModel. Pokud jsou potřeba následné operace, jako je "Verify", "Identify", "Find Similar", zadejte model rozpoznávání s parametrem recognitionModel. Výchozí hodnota pro "recognitionModel" je "recognition_01", pokud je potřeba nejnovější model, explicitně zadejte požadovaný model v tomto parametru. Po zadání se zjištěné id tváře přidružují k zadanému modelu rozpoznávání. Další podrobnosti najdete v https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.
faceIdTimeToLive	query		integer int32	Počet sekund pro id tváře, které se ukládá do mezipaměti. Podporovaný rozsah je od 60 sekund do 86400 sekund. Výchozí hodnota je 86400 (24 hodin).
recognitionModel	query		RecognitionModel	"recognitionModel" přidružený k detekovaným faceIds. Mezi podporované hodnoty recognitionModel patří recognition_01, recognition_02, recognition_03 nebo recognition_04. Výchozí hodnota je recognition_01. "recognition_04" se doporučuje, protože jeho přesnost je vylepšená u tváří s maskami na sobě ve srovnání s "recognition_03" a její celková přesnost se v porovnání s "recognition_01" a "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Analyzujte a vraťte jeden nebo více zadaných atributů tváře v řetězci odděleném čárkami, například returnFaceAttributes=headPose, brýle. Analýza atributů tváře má další výpočetní a časové náklady.
returnFaceId	query		boolean	Vrátí faceId detekovaných tváří nebo ne. Výchozí hodnota je true.
returnFaceLandmarks	query		boolean	Vrátí orientační body tváře rozpoznaných tváří nebo ne. Výchozí hodnota je false.
returnRecognitionModel	query		boolean	Vraťte "recognitionModel" nebo ne. Výchozí hodnota je false. To platí pouze v případě, že returnFaceId = true.

Text požadavku

Media Types: "application/octet-stream"

Name	Typ	Description
imageContent	string	Binární soubor vstupního obrázku.

Odpovědi

Name	Typ	Description
200 OK	FaceDetectionResult[]	Úspěšné volání vrátí pole položek tváře seřazených podle velikosti obdélníku tváře v sestupném pořadí. Prázdná odpověď indikuje, že se nezjistily žádné tváře.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

200 OK

FaceDetectionResult[]

Úspěšné volání vrátí pole položek tváře seřazených podle velikosti obdélníku tváře v sestupném pořadí. Prázdná odpověď indikuje, že se nezjistily žádné tváře.

Other Status Codes

FaceErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

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

Příklady

Detect with Image

Ukázkový požadavek

HTTP

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

"<your-image-bytes-here>"

Ukázková odpověď

Stavový kó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"
    }
  }
]

Definice

Name	Description
AccessoryItem	Položka příslušenství a odpovídající úroveň spolehlivosti
AccessoryType	Typ příslušenství.
BlurLevel	Označuje úroveň rozmazanosti.
BlurProperties	Vlastnosti popisující jakoukoli přítomnost rozostření v obrázku
DetectionModel	Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.
ExposureLevel	Označuje úroveň expozice.
ExposureProperties	Vlastnosti popisující úroveň expozice obrázku
FaceAttributes	Atributy tváře pro rozpoznanou tvář.
FaceAttributeType	Analyzujte a vraťte jeden nebo více zadaných atributů tváře v řetězci odděleném čárkami, například returnFaceAttributes=headPose, brýle. Analýza atributů tváře má další výpočetní a časové náklady.
FaceDetectionResult	Odpověď na rozhraní API pro detekci
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
FaceLandmarks	Kolekce 27bodových orientačních bodů směřujících na důležité pozice součástí tváře.
FaceRectangle	Obdélník, ve kterém lze najít tvář.
FacialHair	Vlastnosti popisující atributy vlasů na obličeji
GlassesType	Brýle typu obličeje.
HairColor	Pole kandidátskýchbarevch
HairColorType	Název barvy vlasů.
HairProperties	Vlastnosti popisující atributy vlasů
HeadPose	3D roll/yaw/pitch úhly pro směr tváře.
LandmarkCoordinate	Souřadnice orientačních bodů v obrázku
MaskProperties	Vlastnosti popisující přítomnost masky na daném obličeji
MaskType	Typ masky.
NoiseLevel	Označuje úroveň šumu.
NoiseProperties	Vlastnosti popisující úroveň šumu obrázku
OcclusionProperties	Vlastnosti popisující okluze na dané tváři
QualityForRecognition	Označuje kvalitu obrázku pro rozpoznávání.
RecognitionModel	Model rozpoznávání tváře.

AccessoryItem

Položka příslušenství a odpovídající úroveň spolehlivosti

Name	Typ	Description
confidence	number	Úroveň spolehlivosti typu příslušenství Rozsah mezi [0,1].
type	AccessoryType	Typ příslušenství.

AccessoryType

Typ příslušenství.

Name	Typ	Description
glasses	string	Brýle.
headwear	string	Nosil hlavu.
mask	string	Maska.

BlurLevel

Označuje úroveň rozmazanosti.

Name	Typ	Description
high	string	Vysoká úroveň rozostření.
low	string	Nízká úroveň rozostření.
medium	string	Střední úroveň rozostření.

BlurProperties

Vlastnosti popisující jakoukoli přítomnost rozostření v obrázku

Name	Typ	Description
blurLevel	BlurLevel	Hodnota výčtu označující úroveň rozmazanosti.
value	number	Číslo označující úroveň rozmazanosti od 0 do 1.

DetectionModel

Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.

Name	Typ	Description
detection_01	string	Výchozí model detekce. Doporučujeme pro detekci přední tváře. Ve scénářích s mimořádně velkým úhlem (pozice hlavy), odlehlé tváře nebo nesprávnou orientací obrázku nemusí být rozpoznány tváře v takových případech.
detection_02	string	Model detekce vydaný v květnu 2019 s vylepšenou přesností zejména na malých, bočních a rozmazaných tvářích.
detection_03	string	Model detekce vydaný v únoru 2021 s vylepšenou přesností zejména u malých tváří.

ExposureLevel

Označuje úroveň expozice.

Name	Typ	Description
goodExposure	string	Dobrá úroveň expozice.
overExposure	string	Vysoká úroveň expozice.
underExposure	string	Nízká úroveň expozice.

ExposureProperties

Vlastnosti popisující úroveň expozice obrázku

Name	Typ	Description
exposureLevel	ExposureLevel	Výčtová hodnota označující úroveň expozice.
value	number	Číslo označující úroveň expozice v rozsahu od 0 do 1. [0, 0,25) je pod expozicí. [0,25, 0,75) je dobrá expozice. [0,75, 1] je nad expozicí.

FaceAttributes

Atributy tváře pro rozpoznanou tvář.

Name	Typ	Description
accessories	AccessoryItem[]	Vlastnosti popisující veškeré příslušenství na daném obličeji.
age	number	Věk v letech.
blur	BlurProperties	Vlastnosti popisující jakoukoli přítomnost rozostření v obrázku
exposure	ExposureProperties	Vlastnosti popisující úroveň expozice obrázku
facialHair	FacialHair	Vlastnosti popisující atributy vlasů na obličeji
glasses	GlassesType	Brýle napište, pokud některý z obličejů.
hair	HairProperties	Vlastnosti popisující atributy vlasů
headPose	HeadPose	3D roll/yaw/pitch úhly pro směr tváře.
mask	MaskProperties	Vlastnosti popisující přítomnost masky na daném obličeji
noise	NoiseProperties	Vlastnosti popisující úroveň šumu obrázku
occlusion	OcclusionProperties	Vlastnosti popisující okluze na dané tváři
qualityForRecognition	QualityForRecognition	Vlastnosti popisující celkovou kvalitu obrázku, pokud jde o to, jestli je obrázek použitý v detekci dostatečně kvalitní k pokusu o rozpoznávání tváře.
smile	number	Intenzita úsměvu, číslo mezi [0,1].

FaceAttributeType

Analyzujte a vraťte jeden nebo více zadaných atributů tváře v řetězci odděleném čárkami, například returnFaceAttributes=headPose, brýle. Analýza atributů tváře má další výpočetní a časové náklady.

Name	Typ	Description
accessories	string	Příslušenství kolem obličeje, včetně "čelenky", "brýle" a "masky". Prázdné pole znamená, že nebyly zjištěny žádné příslušenství. Všimněte si, že je to po zjištění tváře. Velká maska by mohla způsobit, že se nezjistí žádná tvář.
age	string	Věk v letech.
blur	string	Obličej je rozmazaný nebo ne. Funkce Level vrátí hodnotu Low, Medium nebo High. Hodnota vrátí číslo v rozsahu [0,1], čím je rozmazanější.
exposure	string	Úroveň expozice obličeje. Úroveň vrátí hodnotu GoodExposure, OverExposure nebo UnderExposure.
facialHair	string	Vlastnosti popisující atributy vlasů na obličeji
glasses	string	Typ brýle. Mezi hodnoty patří NoGlasses, ReadingGlasses, Sunglasses, SwimmingGoggles.
hair	string	Vlastnosti popisující atributy vlasů
headPose	string	3D roll/yaw/pitch úhly pro směr tváře.
mask	string	Jestli má každý obličej masku. Typ masky vrátí výraz "noMask", 'faceMask', 'otherMaskOrOcclusion' nebo 'neurčitý'. Hodnota vrátí logickou hodnotu "noseAndMouthCovered" označující, zda jsou nos a ústa pokryty.
noise	string	Úroveň šumu v pixelech tváře. Funkce Level vrátí hodnotu Low, Medium a High. Hodnota vrátí číslo v rozsahu [0,1], tím větší je noisier.
occlusion	string	Zda je každá oblast obličeje odlehlé, včetně popředí, očí a úst.
qualityForRecognition	string	Celková kvalita obrázku týkající se toho, jestli je obrázek použitý v detekci dostatečně kvalitní k pokusu o rozpoznávání tváře. Hodnota je neformální hodnocení nízké, střední nebo vysoké. Pro scénáře identifikace se doporučují pouze obrázky s vysokou kvalitou pro registraci osob a kvalitu na "střední" nebo vyšší. Atribut je k dispozici pouze při použití modelů rozpoznávání recognition_03 nebo recognition_04.
smile	string	Intenzita úsměvu, číslo mezi [0,1].

FaceDetectionResult

Odpověď na rozhraní API pro detekci

Name	Typ	Description
faceAttributes	FaceAttributes	Atributy tváře pro rozpoznanou tvář.
faceId	string	Jedinečné faceId rozpoznané tváře vytvořené rozhraním API pro detekci a jeho platnost vyprší 24 hodin po volání detekce. Aby se to vrátilo, vyžaduje, aby byl parametr returnFaceId pravdivý.
faceLandmarks	FaceLandmarks	Pole 27bodových orientačních bodů směřujících na důležité pozice součástí tváře. Aby se tento parametr vrátil, vyžaduje, aby byl parametr returnFaceLandmarks pravdivý.
faceRectangle	FaceRectangle	Obdélníková oblast pro umístění tváře na obrázku.
recognitionModel	RecognitionModel	Model recognitionModel přidružený k tomuto faceId. Tato hodnota se vrátí pouze v případě, že je vlastnost returnRecognitionModel explicitně nastavena jako true.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

FaceLandmarks

Kolekce 27bodových orientačních bodů směřujících na důležité pozice součástí tváře.

Name	Typ	Description
eyeLeftBottom	LandmarkCoordinate	Souřadnice levého oka dole.
eyeLeftInner	LandmarkCoordinate	Souřadnice levého oka vnitřní.
eyeLeftOuter	LandmarkCoordinate	Souřadnice levého oka vnější.
eyeLeftTop	LandmarkCoordinate	Souřadnice levého oka nahoře.
eyeRightBottom	LandmarkCoordinate	Souřadnice pravého oka dole.
eyeRightInner	LandmarkCoordinate	Souřadnice pravého oka vnitřní.
eyeRightOuter	LandmarkCoordinate	Souřadnice pravého oka vnější.
eyeRightTop	LandmarkCoordinate	Souřadnice pravého oka nahoře.
eyebrowLeftInner	LandmarkCoordinate	Souřadnice levého obočí vnitřní.
eyebrowLeftOuter	LandmarkCoordinate	Souřadnice levého obočí vnějšího.
eyebrowRightInner	LandmarkCoordinate	Souřadnice pravého obočí vnitřní.
eyebrowRightOuter	LandmarkCoordinate	Souřadnice pravého obočí vnějšího.
mouthLeft	LandmarkCoordinate	Souřadnice úst vlevo.
mouthRight	LandmarkCoordinate	Souřadnice úst vpravo.
noseLeftAlarOutTip	LandmarkCoordinate	Souřadnice nosu vlevo alar ven špička.
noseLeftAlarTop	LandmarkCoordinate	Souřadnice nosu vlevo alar nahoře.
noseRightAlarOutTip	LandmarkCoordinate	Souřadnice nosu vpravo alar ven špička.
noseRightAlarTop	LandmarkCoordinate	Souřadnice nosu vpravo alar nahoře.
noseRootLeft	LandmarkCoordinate	Souřadnice kořene nosu vlevo.
noseRootRight	LandmarkCoordinate	Souřadnice kořene nosu vpravo.
noseTip	LandmarkCoordinate	Souřadnice špičky nosu.
pupilLeft	LandmarkCoordinate	Souřadnice levého oka žáka.
pupilRight	LandmarkCoordinate	Souřadnice pravého oka žáka.
underLipBottom	LandmarkCoordinate	Souřadnice spodní části rtu.
underLipTop	LandmarkCoordinate	Souřadnice horní části rtu.
upperLipBottom	LandmarkCoordinate	Souřadnice horního rtu dole.
upperLipTop	LandmarkCoordinate	Souřadnice horního rtu nahoře.

FaceRectangle

Obdélník, ve kterém lze najít tvář.

Name	Typ	Description
height	integer	Výška obdélníku v pixelech.
left	integer	Vzdálenost od levého okraje, pokud je obrázek na levém okraji obdélníku v pixelech.
top	integer	Vzdálenost od horního okraje, pokud je obrázek na horním okraji obdélníku v pixelech.
width	integer	Šířka obdélníku v pixelech.

FacialHair

Vlastnosti popisující atributy vlasů na obličeji

Name	Typ	Description
beard	number	Číslo od 0 do 1 označující úroveň spolehlivosti přidruženou k vlastnosti.
moustache	number	Číslo od 0 do 1 označující úroveň spolehlivosti přidruženou k vlastnosti.
sideburns	number	Číslo od 0 do 1 označující úroveň spolehlivosti přidruženou k vlastnosti.

GlassesType

Brýle typu obličeje.

Name	Typ	Description
noGlasses	string	Žádné brýle na obličeji.
readingGlasses	string	Normální brýle na obličeji.
sunglasses	string	Sluneční brýle na obličeji.
swimmingGoggles	string	Plavat brýle na obličeji.

HairColor

Pole kandidátskýchbarevch

Name	Typ	Description
color	HairColorType	Název barvy vlasů.
confidence	number	Úroveň spolehlivosti barvy. Rozsah mezi [0,1].

HairColorType

Název barvy vlasů.

Name	Typ	Description
black	string	Černý.
blond	string	Blonďatý.
brown	string	Hnědý.
gray	string	Šedý.
other	string	Jiný.
red	string	Červený.
unknown	string	Neznámý.
white	string	Bílý.

HairProperties

Vlastnosti popisující atributy vlasů

Name	Typ	Description
bald	number	Číslo popisující úroveň spolehlivosti, zda je osoba plešatý.
hairColor	HairColor[]	Pole kandidátskýchbarevch
invisible	boolean	Logická hodnota popisující, zda jsou vlasy viditelné na obrázku.

HeadPose

3D roll/yaw/pitch úhly pro směr tváře.

Name	Typ	Description
pitch	number	Hodnota úhlů
roll	number	Hodnota úhlů
yaw	number	Hodnota úhlů

LandmarkCoordinate

Souřadnice orientačních bodů v obrázku

Name	Typ	Description
x	number	Vodorovná komponenta v pixelech.
y	number	Svislá komponenta v pixelech.

MaskProperties

Vlastnosti popisující přítomnost masky na daném obličeji

Name	Typ	Description
noseAndMouthCovered	boolean	Logická hodnota označující, zda jsou nos a ústa pokryty.
type	MaskType	Typ masky.

MaskType

Typ masky.

Name	Typ	Description
faceMask	string	Obličejová roušky.
noMask	string	Žádná maska.
otherMaskOrOcclusion	string	Jiné typy masky nebo okluze.
uncertain	string	Nejistý.

NoiseLevel

Označuje úroveň šumu.

Name	Typ	Description
high	string	Vysoká úroveň hluku.
low	string	Nízká úroveň hluku.
medium	string	Střední úroveň šumu.

NoiseProperties

Vlastnosti popisující úroveň šumu obrázku

Name	Typ	Description
noiseLevel	NoiseLevel	Hodnota výčtu označující úroveň šumu.
value	number	Číslo označující úroveň šumu v rozsahu od 0 do 1. [0, 0,25) je pod expozicí. [0,25, 0,75) je dobrá expozice. [0,75, 1] je nad expozicí. [0, 0,3) je nízká úroveň hluku. [0.3, 0,7) je střední úroveň šumu. [0,7, 1] je vysoká úroveň hluku.

OcclusionProperties

Vlastnosti popisující okluze na dané tváři

Name	Typ	Description
eyeOccluded	boolean	Logická hodnota označující, zda jsou oči odlehlé.
foreheadOccluded	boolean	Logická hodnota označující, zda je předsaděná hlava.
mouthOccluded	boolean	Logická hodnota označující, zda je ústa odlehlé.

QualityForRecognition

Označuje kvalitu obrázku pro rozpoznávání.

Name	Typ	Description
high	string	Vysoce kvalitní.
low	string	Nízká kvalita.
medium	string	Střední kvalita.

RecognitionModel

Model rozpoznávání tváře.

Name	Typ	Description
recognition_01	string	Výchozí model rozpoznávání pro "Zjistit". Všechny tyto faceId vytvořené před březnem 2019 jsou vázány s tímto modelem rozpoznávání.
recognition_02	string	Model rozpoznávání vydaný v březnu 2019
recognition_03	string	Model rozpoznávání vydaný v květnu 2020.
recognition_04	string	Model rozpoznávání vydaný v únoru 2021. Pro lepší přesnost rozpoznávání se doporučuje použít tento model rozpoznávání.

Sdílet prostřednictvím

Face Detection Operations - Detect

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

AADToken

Rozsahy

Příklady

Detect with Image

Ukázkový požadavek

Ukázková odpověď

Definice

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

Další materiály