Face Detection Operations - Detect

Hizmet:

Azure AI Services

API Sürümü:

v1.1-preview.1

Bir görüntüdeki insan yüzlerini algılama, yüz dikdörtgenleri döndürme ve isteğe bağlı olarak faceId değerleri, yer işaretleri ve özniteliklerle.

Önemli

İnsanları stereotipleme, ayrımcılık veya haksız hizmet reddine maruz bırakabilecek olası kötüye kullanımı azaltmak için duygu, cinsiyet, yaş, gülümseme, yüz kılı, saç ve makyajı tahmin eden Yüz Tanıma API'si özniteliklerini kullanımdan kaldırıyoruz. Bu karar https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/hakkında daha fazla bilgi edinin.

• • Hiçbir görüntü depolanmaz. Sunucuda yalnızca ayıklanan yüz özellikleri depolanır. faceId, yüz özelliğinin tanımlayıcısıdır ve "Tanımla", "Doğrula" ve "Benzerini Bul" içinde kullanılır. Depolanan yüz özelliklerinin süresi dolar ve özgün algılama çağrısından sonra faceIdTimeToLive tarafından belirtilen zamanda silinir.
  • İsteğe bağlı parametreler arasında faceId, yer işaretleri ve öznitelikler bulunur. HeadPose, gözlük, tıkanıklık, aksesuarlar, bulanıklık, pozlama, gürültü, maske ve qualityForRecognition öznitelikleridir. Belirli öznitelikler için döndürülen sonuçlardan bazıları yüksek oranda doğru olmayabilir.
  • JPEG, PNG, GIF (ilk kare) ve BMP biçimi desteklenir. İzin verilen görüntü dosyası boyutu 1 KB'tan 6 MB'a kadardır.
  • Algılanabilir en düşük yüz boyutu, 1920x1080 pikselden büyük olmayan bir görüntüde 36x36 pikseldir. Boyutları 1920x1080 pikselden yüksek olan görüntüler, orantılı olarak daha büyük bir minimum yüz boyutuna ihtiyaç duyar.
  • Bir görüntü için en fazla 100 yüz döndürülebilir. Yüzler, büyükten küçüke yüz dikdörtgeni boyutuna göre sıralanır.
  • "Tanımla", "Doğrula" ve "Benzerini Bul" ('returnFaceId' true) sorgulanırken en iyi sonuçları elde etmek için lütfen ön, açık ve minimum boyutu 200x200 piksel (gözler arasında 100 piksel) olan yüzleri kullanın.
  • Farklı 'detectionModel' değerleri sağlanabilir. Farklı algılama modellerini kullanmak ve karşılaştırmak için lütfen https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
    • 'detection_02': Bu algılama modelini seçerseniz yüz öznitelikleri ve yer işaretleri devre dışı bırakılır.
    • 'detection_03': Bu algılama modelini seçerseniz yüz öznitelikleri (maske, bulanıklaştırma ve headPose) ve yer işaretleri desteklenir.
  • Farklı 'recognitionModel' değerleri sağlanır. "Doğrula", "Tanımla", "Benzerini Bul" gibi izleme işlemleri gerekiyorsa, lütfen 'recognitionModel' parametresiyle tanıma modelini belirtin. 'recognitionModel' için varsayılan değer 'recognition_01'dir, en son model gerekiyorsa lütfen bu parametrede ihtiyacınız olan modeli açıkça belirtin. Belirtildikten sonra, algılanan faceId'ler belirtilen tanıma modeliyle ilişkilendirilecektir. Diğer ayrıntılar için bkz https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model. .

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
apiVersion	path	True	string	API Sürümü
endpoint	path	True	string uri	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Algılanan faceId'lerle ilişkili 'detectionModel'. Desteklenen 'detectionModel' değerleri şunlardır: 'detection_01', 'detection_02' ve 'detection_03'. Varsayılan değer :'detection_01'.
faceIdTimeToLive	query		integer int32	Önbelleğe alınan yüz kimliğinin saniye sayısı. Desteklenen aralık 60 saniyeden 86400 saniyeye kadardır. Varsayılan değer 86400'dür (24 saat).
recognitionModel	query		RecognitionModel	Algılanan faceId'lerle ilişkili 'recognitionModel'. Desteklenen 'recognitionModel' değerleri 'recognition_01', 'recognition_02', 'recognition_03' veya 'recognition_04' değerlerini içerir. Varsayılan değer :'recognition_01'. 'recognition_04', 'recognition_03' ile karşılaştırıldığında maske takan yüzlerde doğruluğu iyileştirildiğinden ve genel doğruluğu 'recognition_01' ve 'recognition_02' ile karşılaştırıldığında iyileştirildiğinden önerilir.
returnFaceAttributes	query		FaceAttributeType[]	Virgülle ayrılmış dizede 'returnFaceAttributes=headPose,glasses' gibi belirtilen bir veya daha fazla yüz özniteliğini analiz edin ve döndürebilirsiniz. Yüz özniteliği analizinin ek hesaplama ve zaman maliyeti vardır.
returnFaceId	query		boolean	Algılanan yüzlerin faceId değerlerini döndür ya da döndürme. Varsayılan değer true şeklindedir.
returnFaceLandmarks	query		boolean	Algılanan yüzlerin yüz işaretlerini döndür veya döndürme. Varsayılan değer false'tur.
returnRecognitionModel	query		boolean	'recognitionModel' döndür veya döndürme. Varsayılan değer false'tur. Bu yalnızca returnFaceId = true olduğunda geçerlidir.

İstek Gövdesi

Media Types: "application/octet-stream"

Name	Tür	Description
imageContent	string	Giriş görüntüsü ikili dosyası.

Yanıtlar

Name	Tür	Description
200 OK	FaceDetectionResult[]	Başarılı bir çağrı, yüz dikdörtgeni boyutuna göre azalan sırada sıralanmış bir yüz girdileri dizisi döndürür. Boş bir yanıt algılanan yüz olmadığını gösterir.
Other Status Codes	FaceErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure AI Yüz Tanıma aboneliğinizin gizli anahtarı.

Tür: apiKey
İçinde: header

AADToken

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://api.example.com/oauth2/authorize
Belirteç URL'si: https://api.example.com/oauth2/token

Kapsamlar

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

Örnekler

Detect with Image

Örnek isteği

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

Örnek yanıt

Durum kodu:

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"
    }
  }
]

Tanımlar

Name	Description
AccessoryItem	Aksesuar öğesi ve ilgili güvenilirlik düzeyi.
AccessoryType	Aksesuarın türü.
BlurLevel	Bulanıklık düzeyini gösterir.
BlurProperties	Görüntüdeki bulanıklık durumunu açıklayan özellikler.
DetectionModel	Algılanan faceId'lerle ilişkili 'detectionModel'. Desteklenen 'detectionModel' değerleri şunlardır: 'detection_01', 'detection_02' ve 'detection_03'. Varsayılan değer :'detection_01'.
ExposureLevel	Maruz kalma düzeyini gösterir.
ExposureProperties	Görüntünün pozlama düzeyini açıklayan özellikler.
FaceAttributes	Algılanan yüz için yüz öznitelikleri.
FaceAttributeType	Virgülle ayrılmış dizede 'returnFaceAttributes=headPose,glasses' gibi belirtilen bir veya daha fazla yüz özniteliğini analiz edin ve döndürebilirsiniz. Yüz özniteliği analizinin ek hesaplama ve zaman maliyeti vardır.
FaceDetectionResult	Algılama API'sini yanıtlama.
FaceError	Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar için lütfen aşağıdaki bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hata ayrıntılarını içeren bir yanıt.
FaceLandmarks	Yüz bileşenlerinin önemli konumlarına işaret eden 27 noktalı yüz yer işaretlerinden oluşan bir koleksiyon.
FaceRectangle	İçinde bir yüzün bulunabileceği dikdörtgen.
FacialHair	Yüz kılı özniteliklerini açıklayan özellikler.
GlassesType	Gözlük tipi yüz.
HairColor	Her birinin varlığında bir dizi aday renk ve güvenilirlik düzeyi.
HairColorType	Saç renginin adı.
HairProperties	Saç özniteliklerini açıklayan özellikler.
HeadPose	Yüz yönü için 3-B rulo/yaw/perde açıları.
LandmarkCoordinate	Görüntü içindeki yer işareti koordinatları.
MaskProperties	Belirli bir yüzdeki maskenin varlığını açıklayan özellikler.
MaskType	Maskenin türü.
NoiseLevel	Kirlilik düzeyini gösterir.
NoiseProperties	Görüntünün kirlilik düzeyini açıklayan özellikler.
OcclusionProperties	Belirli bir yüzdeki tıkanıklıkları açıklayan özellikler.
QualityForRecognition	Tanıma için görüntü kalitesini gösterir.
RecognitionModel	Yüzün tanıma modeli.

AccessoryItem

Aksesuar öğesi ve ilgili güvenilirlik düzeyi.

Name	Tür	Description
confidence	number	Aksesuar türünün güvenilirlik düzeyi. [0,1] arasındaki aralık.
type	AccessoryType	Aksesuarın türü.

AccessoryType

Aksesuarın türü.

Name	Tür	Description
glasses	string	Gözlük.
headwear	string	Kafa aşınması.
mask	string	Maske.

BlurLevel

Bulanıklık düzeyini gösterir.

Name	Tür	Description
high	string	Yüksek bulanıklık düzeyi.
low	string	Düşük bulanıklık düzeyi.
medium	string	Orta bulanıklık düzeyi.

BlurProperties

Görüntüdeki bulanıklık durumunu açıklayan özellikler.

Name	Tür	Description
blurLevel	BlurLevel	Bulanıklık düzeyini gösteren bir sabit listesi değeri.
value	number	0 ile 1 arasında değişen bulanıklık düzeyini gösteren bir sayı.

DetectionModel

Algılanan faceId'lerle ilişkili 'detectionModel'. Desteklenen 'detectionModel' değerleri şunlardır: 'detection_01', 'detection_02' ve 'detection_03'. Varsayılan değer :'detection_01'.

Name	Tür	Description
detection_01	string	Varsayılan algılama modeli. Neredeyse ön yüz algılama için önerilir. Olağanüstü büyük açılı (baş pozu) yüzler, kapatılmış yüzler veya yanlış görüntü yönlendirmesi olan senaryolarda, bu tür durumlarda yüzler algılanmayabilir.
detection_02	string	Özellikle küçük, yan ve bulanık yüzlerde geliştirilmiş doğrulukla 2019 Mayıs ayında yayımlanan algılama modeli.
detection_03	string	2021 Şubat'ta kullanıma sunulan algılama modeli, özellikle küçük yüzlerde geliştirilmiş doğrulukla.

ExposureLevel

Maruz kalma düzeyini gösterir.

Name	Tür	Description
goodExposure	string	İyi pozlama seviyesi.
overExposure	string	Yüksek pozlama düzeyi.
underExposure	string	Düşük pozlama düzeyi.

ExposureProperties

Görüntünün pozlama düzeyini açıklayan özellikler.

Name	Tür	Description
exposureLevel	ExposureLevel	Maruz kalma düzeyini gösteren bir sabit listesi değeri.
value	number	0 ile 1 arasında pozlama düzeyini gösteren bir sayı. [0, 0,25) maruziyet altındadır. [0,25, 0,75) iyi pozlamadır. [0,75, 1] fazla pozlama.

FaceAttributes

Algılanan yüz için yüz öznitelikleri.

Name	Tür	Description
accessories	AccessoryItem[]	Belirli bir yüzdeki aksesuarları açıklayan özellikler.
age	number	Yıllar içinde yaşa.
blur	BlurProperties	Görüntüdeki bulanıklık varlığını açıklayan özellikler.
exposure	ExposureProperties	Görüntünün pozlama düzeyini açıklayan özellikler.
facialHair	FacialHair	Yüz kılı özniteliklerini açıklayan özellikler.
glasses	GlassesType	Gözlük, yüzün herhangi biriyse, bunu yaz.
hair	HairProperties	Saç özniteliklerini açıklayan özellikler.
headPose	HeadPose	Yüz yönü için 3-B rulo/yaw/pitch açıları.
mask	MaskProperties	Belirli bir yüzdeki maskenin varlığını açıklayan özellikler.
noise	NoiseProperties	Görüntünün kirlilik düzeyini açıklayan özellikler.
occlusion	OcclusionProperties	Belirli bir yüzdeki tıkanıklıkları açıklayan özellikler.
qualityForRecognition	QualityForRecognition	Algılamada kullanılan görüntünün yüz tanımayı deneyecek kadar kaliteli olup olmadığına ilişkin genel görüntü kalitesini açıklayan özellikler.
smile	number	Gülümseme yoğunluğu, [0,1] arasında bir sayı.

FaceAttributeType

Virgülle ayrılmış dizede 'returnFaceAttributes=headPose,glasses' gibi belirtilen bir veya daha fazla yüz özniteliğini analiz edin ve döndürebilirsiniz. Yüz özniteliği analizinin ek hesaplama ve zaman maliyeti vardır.

Name	Tür	Description
accessories	string	'Şapka', 'gözlük' ve 'maske' dahil olmak üzere yüz çevresindeki aksesuarlar. Boş dizi, hiçbir aksesuar algılanmadı anlamına gelir. Bunun bir yüz algılandıktan sonra olduğunu unutmayın. Büyük maske, hiçbir yüzün algılanmasıyla sonuçlanabilir.
age	string	Yıllar içinde yaşa.
blur	string	Yüz bulanık ya da değil. Düzey 'Düşük', 'Orta' veya 'Yüksek' döndürür. Değer [0,1] arasında bir sayı döndürür; bulanıklık ne kadar büyükse o kadar büyük olur.
exposure	string	Yüz maruz kalma düzeyi. Düzey , 'GoodExposure', 'OverExposure' veya 'UnderExposure' döndürür.
facialHair	string	Yüz kılı özniteliklerini açıklayan özellikler.
glasses	string	Gözlük türü. Değerler arasında 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles' bulunur.
hair	string	Saç özniteliklerini açıklayan özellikler.
headPose	string	Yüz yönü için 3-B rulo/yaw/pitch açıları.
mask	string	Her yüzün maske takıp takmadığı. Maske türü 'noMask', 'faceMask', 'otherMaskOrOcclusion' veya 'uncertain' döndürür. Değer, burun ve ağzın kaplanıp kaplanmadığını belirten bir boole değeri 'noseAndMouthCovered' döndürür.
noise	string	Yüz piksellerinin kirlilik düzeyi. Düzey 'Düşük', 'Orta' ve 'Yüksek' döndürür. Değer [0,1] arasında bir sayı döndürür; aday ne kadar büyükse o kadar büyük
occlusion	string	Alın, gözler ve ağız dahil olmak üzere her yüz alanının tıkanmış olup olmadığı.
qualityForRecognition	string	Algılamada kullanılan görüntünün yüz tanımayı deneyecek kadar kaliteli olup olmadığına ilişkin genel görüntü kalitesi. Değer, düşük, orta veya yüksek resmi olmayan bir derecelendirmedir. Kişi kaydı için yalnızca 'yüksek' kaliteli görüntüler önerilir ve tanımlama senaryolarında 'orta' veya üzeri kalite önerilir. Özniteliği yalnızca tanıma modelleri recognition_03 veya recognition_04 kullanıldığında kullanılabilir.
smile	string	Gülümseme yoğunluğu, [0,1] arasında bir sayı.

FaceDetectionResult

Algılama API'sini yanıtlama.

Name	Tür	Description
faceAttributes	FaceAttributes	Algılanan yüz için yüz öznitelikleri.
faceId	string	Algılama API'si tarafından oluşturulan ve algılama çağrısından 24 saat sonra süresi dolacak algılanan yüzün benzersiz faceId değeri. Bunu döndürmek için 'returnFaceId' parametresinin true olması gerekir.
faceLandmarks	FaceLandmarks	Yüz bileşenlerinin önemli konumlarına işaret eden 27 noktalı yüz yer işaretlerinden oluşan bir dizi. Bunu döndürmek için 'returnFaceLandmarks' parametresinin true olması gerekir.
faceRectangle	FaceRectangle	Görüntüdeki yüz konumu için dikdörtgen bir alan.
recognitionModel	RecognitionModel	Bu faceId ile ilişkili 'recognitionModel'. Bu yalnızca 'returnRecognitionModel' açıkça true olarak ayarlandığında döndürülür.

FaceError

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar için lütfen aşağıdaki bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
message	string	Hatanın insanlar tarafından okunabilir bir gösterimi.

FaceErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	FaceError	Hata nesnesi.

FaceLandmarks

Yüz bileşenlerinin önemli konumlarına işaret eden 27 noktalı yüz yer işaretlerinden oluşan bir koleksiyon.

Name	Tür	Description
eyeLeftBottom	LandmarkCoordinate	Sol göz alt koordinatları.
eyeLeftInner	LandmarkCoordinate	Sol göz iç koordinatları.
eyeLeftOuter	LandmarkCoordinate	Sol gözün dış koordinatları.
eyeLeftTop	LandmarkCoordinate	Sol gözün üst koordinatları.
eyeRightBottom	LandmarkCoordinate	Sağ göz alt koordinatları.
eyeRightInner	LandmarkCoordinate	Sağ göz iç koordinatları.
eyeRightOuter	LandmarkCoordinate	Sağ gözün dış koordinatları.
eyeRightTop	LandmarkCoordinate	Sağ gözün üst koordinatları.
eyebrowLeftInner	LandmarkCoordinate	Sol kaş iç koordinatları.
eyebrowLeftOuter	LandmarkCoordinate	Sol kaş dış koordinatları.
eyebrowRightInner	LandmarkCoordinate	Sağ kaş iç koordinatları.
eyebrowRightOuter	LandmarkCoordinate	Sağ kaş dış koordinatları.
mouthLeft	LandmarkCoordinate	Ağzın koordinatları gitti.
mouthRight	LandmarkCoordinate	Ağzın sağ koordinatları.
noseLeftAlarOutTip	LandmarkCoordinate	Burnun koordinatları alar ucu dışarıda bıraktı.
noseLeftAlarTop	LandmarkCoordinate	Burnun koordinatları alar üst kısımda kaldı.
noseRightAlarOutTip	LandmarkCoordinate	Burun sağ alar ucu koordinatları.
noseRightAlarTop	LandmarkCoordinate	Burun sağ üst alar koordinatları.
noseRootLeft	LandmarkCoordinate	Burun kökünün koordinatları sol tarafta.
noseRootRight	LandmarkCoordinate	Burun kökü sağ koordinatları.
noseTip	LandmarkCoordinate	Burun ucunun koordinatları.
pupilLeft	LandmarkCoordinate	Sol göz bebeğin koordinatları.
pupilRight	LandmarkCoordinate	Sağ göz bebeğin koordinatları.
underLipBottom	LandmarkCoordinate	Dudak altlarının koordinatları.
underLipTop	LandmarkCoordinate	Dudağın altındaki üst kısımdaki koordinatlar.
upperLipBottom	LandmarkCoordinate	Üst dudak tabanının koordinatları.
upperLipTop	LandmarkCoordinate	Üst dudağın koordinatları.

FaceRectangle

İçinde bir yüzün bulunabileceği dikdörtgen.

Name	Tür	Description
height	integer	Dikdörtgenin piksel cinsinden yüksekliği.
left	integer	Resim piksel cinsinden dikdörtgenin sol kenarına doğruysa, sol kenardan uzaklık.
top	integer	Resim piksel cinsinden dikdörtgenin üst kenarına doğruysa üst kenardan uzaklık.
width	integer	Dikdörtgenin piksel cinsinden genişliği.

FacialHair

Yüz kılı özniteliklerini açıklayan özellikler.

Name	Tür	Description
beard	number	Bir özellikle ilişkili güvenilirlik düzeyini gösteren 0 ile 1 arasında bir sayı.
moustache	number	Bir özellikle ilişkili güvenilirlik düzeyini gösteren 0 ile 1 arasında bir sayı.
sideburns	number	Bir özellikle ilişkili güvenilirlik düzeyini gösteren 0 ile 1 arasında bir sayı.

GlassesType

Gözlük tipi yüz.

Name	Tür	Description
noGlasses	string	Yüzünde gözlük yok.
readingGlasses	string	Yüzünde normal gözlükler var.
sunglasses	string	Yüzünde güneş gözlüğü var.
swimmingGoggles	string	Yüzen gözlükler.

HairColor

Her birinin varlığında bir dizi aday renk ve güvenilirlik düzeyi.

Name	Tür	Description
color	HairColorType	Saç renginin adı.
confidence	number	Rengin güvenilirlik düzeyi. [0,1] arasındaki aralık.

HairColorType

Saç renginin adı.

Name	Tür	Description
black	string	Siyah.
blond	string	Sarışın.
brown	string	Kahverengi.
gray	string	Gri.
other	string	Diğer.
red	string	Kırmızı.
unknown	string	Bilinmiyor.
white	string	Beyaz.

HairProperties

Saç özniteliklerini açıklayan özellikler.

Name	Tür	Description
bald	number	Kişinin kel olup olmadığının güvenilirlik düzeyini açıklayan bir sayı.
hairColor	HairColor[]	Her birinin varlığında bir dizi aday renk ve güvenilirlik düzeyi.
invisible	boolean	Saçın görüntüde görünür olup olmadığını açıklayan boole değeri.

HeadPose

Yüz yönü için 3-B rulo/yaw/perde açıları.

Name	Tür	Description
pitch	number	Açıların değeri.
roll	number	Açıların değeri.
yaw	number	Açıların değeri.

LandmarkCoordinate

Görüntü içindeki yer işareti koordinatları.

Name	Tür	Description
x	number	Piksel cinsinden yatay bileşen.
y	number	Piksel cinsinden dikey bileşen.

MaskProperties

Belirli bir yüzdeki maskenin varlığını açıklayan özellikler.

Name	Tür	Description
noseAndMouthCovered	boolean	Burnun ve ağzın kaplanıp kaplanmadığını gösteren boole değeri.
type	MaskType	Maskenin türü.

MaskType

Maskenin türü.

Name	Tür	Description
faceMask	string	Yüz maskesi.
noMask	string	Maske yok.
otherMaskOrOcclusion	string	Diğer maske veya tıkanıklık türleri.
uncertain	string	Belirsiz.

NoiseLevel

Kirlilik düzeyini gösterir.

Name	Tür	Description
high	string	Yüksek gürültü seviyesi.
low	string	Düşük gürültü seviyesi.
medium	string	Orta gürültü seviyesi.

NoiseProperties

Görüntünün kirlilik düzeyini açıklayan özellikler.

Name	Tür	Description
noiseLevel	NoiseLevel	Kirlilik düzeyini gösteren bir sabit listesi değeri.
value	number	0 ile 1 arasında gürültü düzeyini gösteren bir sayı. [0, 0,25) maruziyet altındadır. [0,25, 0,75) iyi pozlamadır. [0,75, 1] fazla pozlama. [0, 0,3) düşük gürültü seviyesidir. [0.3, 0.7) orta gürültü seviyesidir. [0,7, 1] yüksek gürültü seviyesidir.

OcclusionProperties

Belirli bir yüzdeki tıkanıklıkları açıklayan özellikler.

Name	Tür	Description
eyeOccluded	boolean	Gözlerin tıkanıp tıkanmadığını gösteren boole değeri.
foreheadOccluded	boolean	Alnın tıkanıp tıkanmadığını gösteren boole değeri.
mouthOccluded	boolean	Ağzın tıkanıp tıkanmadığını gösteren boole değeri.

QualityForRecognition

Tanıma için görüntü kalitesini gösterir.

Name	Tür	Description
high	string	Yüksek kalite.
low	string	Düşük kalite.
medium	string	Orta kalite.

RecognitionModel

Yüzün tanıma modeli.

Name	Tür	Description
recognition_01	string	"Algıla" için varsayılan tanıma modeli. 2019 Mart'tan önce oluşturulan tüm faceId'ler bu tanıma modeliyle birleştirilmiştir.
recognition_02	string	2019 Mart ayında yayımlanan tanıma modeli.
recognition_03	string	2020 Mayıs ayında yayımlanan tanıma modeli.
recognition_04	string	Tanıma modeli 2021 Şubat'ta yayınlandı. Daha iyi tanıma doğruluğu için bu tanıma modelinin kullanılması önerilir.