Face Detection Operations - Detect

Hizmet:: Azure AI Services

API Sürümü:: v1.2

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

Önemli

Microsoft' un kullanımdan kaldırılmış veya sınırlı yüz tanıma özellikleri vardır ve bu özellikler, kötüye kullanıldığında, insanların stereotipleme, ayrımcılığa veya haksız hizmet reddine maruz kalabilecek duygusal durumları ve kimlik özniteliklerini çıkarsamak için kullanılabilir. Kullanımdan kaldırılacak özellikler duygu ve cinsiyettir. Sınırlı yetenekler yaş, gülümseme, yüz kılları, saç ve makyajdır. Sınırlı özelliklerden herhangi birinin kullanımından yararlanabilecek sorumlu bir kullanım örneğine sahipseniz Azure Yüz Tanıma API'si e-posta. Bu karar hakkında daha fazla bilgi burada.

- 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. Özellikler arasında headPose, gözlük, tıkanıklık, aksesuarlar, bulanıklık, pozlama, gürültü, maske ve qualityForRecognition bulunur. 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.
- "Identify", "Verify" ve "Find Similar" ('returnFaceId' true) sorgulanırken en iyi sonuçları elde etmek için lütfen ön, net ve minimum boyutu 200x200 piksel (gözler arasında 100 piksel) olan yüzleri kullanın.
- Farklı 'detectionModel' değerleri sağlanabilir. Yer işaretlerinin ve desteklenen özniteliklerin kullanılabilirliği, belirtilen algılama modeline bağlıdır. Farklı algılama modellerini kullanmak ve karşılaştırmak için lütfenburadaki bakın.
- 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'dır, 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 lütfenburadaki bakın.

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 'detection_01', 'detection_02' ve 'detection_03' değerlerini içerir. Varsayılan değer :'detection_01'. Doğruluğu daha küçük yüzlerde (64x64 piksel) ve döndürülmüş yüz yönlendirmelerinde iyileştirildiğinden 'detection_03' önerilir.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Önbelleğe alınan yüz kimliği için saniye sayısı. Desteklenen aralık 60 saniye ile 86400 saniye arasındadı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ürin. Yüz özniteliği analizinin ek hesaplama ve zaman maliyeti vardır.
returnFaceId	query		boolean	Algılanan yüzlerin faceId'lerini döndür veya döndürme. Varsayılan değer true değeridir.
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 (binary)	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

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 Yapay Zeka 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.2/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Ö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 buna karşılık gelen 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 'detection_01', 'detection_02' ve 'detection_03' değerlerini içerir. Varsayılan değer :'detection_01'. Doğruluğu daha küçük yüzlerde (64x64 piksel) ve döndürülmüş yüz yönlendirmelerinde iyileştirildiğinden 'detection_03' önerilir.
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ürin. 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 ayrıntılı bilgi için lütfen şu 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	Yüzün gözlük tipi.
HairColor	Her birinin varlığında bir dizi aday rengi 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/pitch açıları.
LandmarkCoordinate	Görüntü içindeki yer işareti koordinatları.
MaskProperties	Belirli bir yüzde 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

Object

Aksesuar öğesi ve buna karşılık gelen güvenilirlik düzeyi.

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

AccessoryType

Listeleme

Aksesuarın türü.

Değer	Description
headwear	Kafa yıpranması.
glasses	Gözlük.
mask	Maske.

BlurLevel

Listeleme

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

Değer	Description
low	Düşük bulanıklık düzeyi.
medium	Orta bulanıklık düzeyi.
high	Yüksek bulanıklık düzeyi.

BlurProperties

Object

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 numaralandırma değeri.
value	number (float) minimum: 0 maximum: 1	Bulanıklık düzeyini 0 ile 1 arasında gösteren bir sayı.

DetectionModel

Listeleme

Algılanan faceId'lerle ilişkili 'detectionModel'. Desteklenen 'detectionModel' değerleri 'detection_01', 'detection_02' ve 'detection_03' değerlerini içerir. Varsayılan değer :'detection_01'. Doğruluğu daha küçük yüzlerde (64x64 piksel) ve döndürülmüş yüz yönlendirmelerinde iyileştirildiğinden 'detection_03' önerilir.

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

ExposureLevel

Listeleme

Maruz kalma düzeyini gösterir.

Değer	Description
underExposure	Düşük pozlama düzeyi.
goodExposure	İyi pozlama seviyesi.
overExposure	Yüksek pozlama düzeyi.

ExposureProperties

Object

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 (float) minimum: 0 maximum: 1	0 ile 1 arasında pozlama düzeyini gösteren bir sayı. [0, 0,25) pozlama altında. [0,25, 0,75) iyi pozlamadır. [0,75, 1] fazla pozlama.

FaceAttributes

Object

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 (float)	Yıllar içinde yaş.
blur	BlurProperties	Görüntüdeki bulanıklık durumunu 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, yazın.
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üzde 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 (float) minimum: 0 maximum: 1	Gülümseme yoğunluğu, [0,1] arasında bir sayı.

FaceAttributeType

Listeleme

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

Değer	Description
headPose	Yüz yönü için 3-B rulo/yaw/pitch açıları.
glasses	Gözlük tipi. Değerler arasında 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles' bulunur.
occlusion	Alın, gözler ve ağız dahil olmak üzere her yüz bölgesinin tıkanmış olup olmadığı.
accessories	"Ş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ğuna dikkat edin. Büyük maske, yüzün algılanmasıyla sonuçlanamaz.
blur	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 o kadar büyük olur.
exposure	Yüz maruz kalma düzeyi. Düzey , 'GoodExposure', 'OverExposure' veya 'UnderExposure' döndürür.
noise	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; noisier ne kadar büyükse
mask	Her yüzün maske takıp takmadığı. Maske türü 'noMask', 'faceMask', 'otherMaskOrOcclusion' veya 'uncertain' döndürür. Değer, burnun ve ağzın kaplanıp kaplanmadığını gösteren bir boole değeri 'noseAndMouthCovered' döndürür.
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ü kalitesi. Değer, düşük, orta veya yüksek için 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 recognition_03 veya recognition_04 tanıma modelleri kullanılırken kullanılabilir.
age	Yıllar içinde yaş.
smile	Gülümseme yoğunluğu, [0,1] arasında bir sayı.
facialHair	Yüz kılı özniteliklerini açıklayan özellikler.
hair	Saç özniteliklerini açıklayan özellikler.

FaceDetectionResult

Object

Algılama API'sini yanıtlama.

Name	Tür	Description
faceAttributes	FaceAttributes	Algılanan yüz için yüz öznitelikleri.
faceId	string (uuid)	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

Object

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu 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 insan tarafından okunabilir bir gösterimi.

FaceErrorResponse

Object

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

Name	Tür	Description
error	FaceError	Hata nesnesi.

FaceLandmarks

Object

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ün iç koordinatları.
eyeLeftOuter	LandmarkCoordinate	Sol göz 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 dış koordinatları.
eyeRightTop	LandmarkCoordinate	Sağ gözün 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ı kaldı.
mouthRight	LandmarkCoordinate	Ağzın sağ koordinatları.
noseLeftAlarOutTip	LandmarkCoordinate	Burnun koordinatları ucun dışında alar bıraktı.
noseLeftAlarTop	LandmarkCoordinate	Burnun koordinatları alar üst kısımda kaldı.
noseRightAlarOutTip	LandmarkCoordinate	Burun sağ alar out ucu koordinatları.
noseRightAlarTop	LandmarkCoordinate	Burnun sağ alar üst koordinatları.
noseRootLeft	LandmarkCoordinate	Burun kökünün koordinatları sol.
noseRootRight	LandmarkCoordinate	Burun kökünün 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 koordinatlar.
upperLipBottom	LandmarkCoordinate	Üst dudak tabanının koordinatları.
upperLipTop	LandmarkCoordinate	Üst dudağın koordinatları.

FaceRectangle

Object

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

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

FacialHair

Object

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

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

GlassesType

Listeleme

Yüzün gözlük tipi.

Değer	Description
noGlasses	Yüzünde gözlük yok.
readingGlasses	Yüzünde normal gözlükler var.
sunglasses	Yüzünde güneş gözlüğü var.
swimmingGoggles	Yüzen gözlükler.

HairColor

Object

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

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

HairColorType

Listeleme

Saç renginin adı.

Değer	Description
unknown	Bilinmeyen.
white	Beyaz.
gray	Gri.
blond	Sarışın.
brown	Kahverengi.
red	Kırmızı.
black	Siyah.
other	Diğer.

HairProperties

Object

Saç özniteliklerini açıklayan özellikler.

Name	Tür	Description
bald	number (float) minimum: 0 maximum: 1	Kişinin kel olup olmadığının güvenilirlik düzeyini açıklayan bir sayı.
hairColor	HairColor[]	Her birinin varlığında bir dizi aday rengi 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

Object

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

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

LandmarkCoordinate

Object

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

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

MaskProperties

Object

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

Name	Tür	Description
noseAndMouthCovered	boolean	Burun ve ağzın örtülü olup olmadığını gösteren boole değeri.
type	MaskType	Maskenin türü.

MaskType

Listeleme

Maskenin türü.

Değer	Description
faceMask	Yüz maskesi.
noMask	Maske yok.
otherMaskOrOcclusion	Diğer maske veya tıkanıklık türleri.
uncertain	Kararsız.

NoiseLevel

Listeleme

Kirlilik düzeyini gösterir.

Değer	Description
low	Düşük gürültü seviyesi.
medium	Orta gürültü seviyesi.
high	Yüksek gürültü seviyesi.

NoiseProperties

Object

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

Name	Tür	Description
noiseLevel	NoiseLevel	Kirlilik düzeyini gösteren bir numaralandırma değeri.
value	number (float) minimum: 0 maximum: 1	0 ile 1 arasında kirlilik düzeyini gösteren bir sayı. [0, 0,25) pozlama altında. [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 kirlilik düzeyidir.

OcclusionProperties

Object

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

Listeleme

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

Değer	Description
low	Düşük kalite.
medium	Orta kalite.
high	Yüksek kalite.

RecognitionModel

Listeleme

Yüzün tanıma modeli.

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