Face Detection Operations - Detect
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
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 |
---|---|---|---|---|
api
|
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). |
detection
|
query |
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'. |
||
face
|
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). |
|
recognition
|
query |
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. |
||
return
|
query |
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. |
||
return
|
query |
boolean |
Algılanan yüzlerin faceId değerlerini döndür ya da döndürme. Varsayılan değer true şeklindedir. |
|
return
|
query |
boolean |
Algılanan yüzlerin yüz işaretlerini döndür veya döndürme. Varsayılan değer false'tur. |
|
return
|
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 |
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 |
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
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
[
{
"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 |
---|---|
Accessory |
Aksesuar öğesi ve ilgili güvenilirlik düzeyi. |
Accessory |
Aksesuarın türü. |
Blur |
Bulanıklık düzeyini gösterir. |
Blur |
Görüntüdeki bulanıklık durumunu açıklayan özellikler. |
Detection |
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'. |
Exposure |
Maruz kalma düzeyini gösterir. |
Exposure |
Görüntünün pozlama düzeyini açıklayan özellikler. |
Face |
Algılanan yüz için yüz öznitelikleri. |
Face |
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. |
Face |
Algılama API'sini yanıtlama. |
Face |
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. |
Face |
Hata ayrıntılarını içeren bir yanıt. |
Face |
Yüz bileşenlerinin önemli konumlarına işaret eden 27 noktalı yüz yer işaretlerinden oluşan bir koleksiyon. |
Face |
İçinde bir yüzün bulunabileceği dikdörtgen. |
Facial |
Yüz kılı özniteliklerini açıklayan özellikler. |
Glasses |
Gözlük tipi yüz. |
Hair |
Her birinin varlığında bir dizi aday renk ve güvenilirlik düzeyi. |
Hair |
Saç renginin adı. |
Hair |
Saç özniteliklerini açıklayan özellikler. |
Head |
Yüz yönü için 3-B rulo/yaw/perde açıları. |
Landmark |
Görüntü içindeki yer işareti koordinatları. |
Mask |
Belirli bir yüzdeki maskenin varlığını açıklayan özellikler. |
Mask |
Maskenin türü. |
Noise |
Kirlilik düzeyini gösterir. |
Noise |
Görüntünün kirlilik düzeyini açıklayan özellikler. |
Occlusion |
Belirli bir yüzdeki tıkanıklıkları açıklayan özellikler. |
Quality |
Tanıma için görüntü kalitesini gösterir. |
Recognition |
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 |
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 |
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 |
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 |
Belirli bir yüzdeki aksesuarları açıklayan özellikler. |
|
age |
number |
Yıllar içinde yaşa. |
blur |
Görüntüdeki bulanıklık varlığını açıklayan özellikler. |
|
exposure |
Görüntünün pozlama düzeyini açıklayan özellikler. |
|
facialHair |
Yüz kılı özniteliklerini açıklayan özellikler. |
|
glasses |
Gözlük, yüzün herhangi biriyse, bunu yaz. |
|
hair |
Saç özniteliklerini açıklayan özellikler. |
|
headPose |
Yüz yönü için 3-B rulo/yaw/pitch açıları. |
|
mask |
Belirli bir yüzdeki maskenin varlığını açıklayan özellikler. |
|
noise |
Görüntünün kirlilik düzeyini açıklayan özellikler. |
|
occlusion |
Belirli bir yüzdeki tıkanıklıkları açıklayan özellikler. |
|
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 |
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 |
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 |
Görüntüdeki yüz konumu için dikdörtgen bir alan. |
|
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 |
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 |
Sol göz alt koordinatları. |
|
eyeLeftInner |
Sol göz iç koordinatları. |
|
eyeLeftOuter |
Sol gözün dış koordinatları. |
|
eyeLeftTop |
Sol gözün üst koordinatları. |
|
eyeRightBottom |
Sağ göz alt koordinatları. |
|
eyeRightInner |
Sağ göz iç koordinatları. |
|
eyeRightOuter |
Sağ gözün dış koordinatları. |
|
eyeRightTop |
Sağ gözün üst koordinatları. |
|
eyebrowLeftInner |
Sol kaş iç koordinatları. |
|
eyebrowLeftOuter |
Sol kaş dış koordinatları. |
|
eyebrowRightInner |
Sağ kaş iç koordinatları. |
|
eyebrowRightOuter |
Sağ kaş dış koordinatları. |
|
mouthLeft |
Ağzın koordinatları gitti. |
|
mouthRight |
Ağzın sağ koordinatları. |
|
noseLeftAlarOutTip |
Burnun koordinatları alar ucu dışarıda bıraktı. |
|
noseLeftAlarTop |
Burnun koordinatları alar üst kısımda kaldı. |
|
noseRightAlarOutTip |
Burun sağ alar ucu koordinatları. |
|
noseRightAlarTop |
Burun sağ üst alar koordinatları. |
|
noseRootLeft |
Burun kökünün koordinatları sol tarafta. |
|
noseRootRight |
Burun kökü sağ koordinatları. |
|
noseTip |
Burun ucunun koordinatları. |
|
pupilLeft |
Sol göz bebeğin koordinatları. |
|
pupilRight |
Sağ göz bebeğin koordinatları. |
|
underLipBottom |
Dudak altlarının koordinatları. |
|
underLipTop |
Dudağın altındaki üst kısımdaki koordinatlar. |
|
upperLipBottom |
Üst dudak tabanının koordinatları. |
|
upperLipTop |
Ü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 |
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 |
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 |
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 |
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. |