Yüz algılama modeli belirtme
Bu kılavuzda, Azure AI Yüz Tanıma hizmeti için yüz algılama modeli belirtme adımları gösterilmektedir.
Yüz Tanıma hizmeti, görüntülerdeki insan yüzleri üzerinde işlemler gerçekleştirmek için makine öğrenmesi modellerini kullanır. Müşteri geri bildirimlerine ve araştırmalardaki ilerlemelere dayanarak modellerimizin doğruluğunu geliştirmeye devam ediyoruz ve bu iyileştirmeleri model güncelleştirmeleri olarak sunacağız. Geliştiriciler yüz algılama modelinin hangi sürümünü kullanmak istediklerini belirtme seçeneğine sahiptir; kullanım örneğine en uygun modeli seçebilirler.
Belirli yüz tanıma işlemlerinde yüz algılama modelini belirtmeyi öğrenmek için okumaya devam edin. Yüz Tanıma hizmeti, bir yüzün görüntüsünü başka bir veri biçimine dönüştürdüğünde yüz algılamayı kullanır.
En son modeli kullanmanız gerekip gerekmediğinden emin değilseniz, yeni modeli değerlendirmek ve geçerli veri kümenizi kullanarak sonuçları karşılaştırmak için Farklı modelleri değerlendir bölümüne atlayın.
Önkoşullar
Yapay zeka yüz algılama kavramı hakkında bilgi sahibi olmanız gerekir. Değilseniz yüz algılama kavramsal kılavuzuna veya nasıl yapılır kılavuzuna bakın:
Farklı modelleri değerlendirme
Farklı yüz algılama modelleri farklı görevler için iyileştirilmiştir. Farklılıklara genel bakış için aşağıdaki tabloya bakın.
| Model | Açıklama | Performans notları | Özellikler | Ünlü yapıtlar |
|---|---|---|---|---|
| detection_01 | Tüm yüz algılama işlemleri için varsayılan seçenek. | Küçük, yan görünümlü veya bulanık yüzler için iyileştirilmemiş. | Algılama çağrısında belirtilmişse ana yüz özniteliklerini (baş pozu, yaş, duygu vb.) döndürür. | Algılama çağrısında belirtilirse yüz yer işaretlerini döndürür. |
| detection_02 | Mayıs 2019'da yayımlanan ve isteğe bağlı olarak tüm yüz algılama işlemlerinde kullanılabilir. | Küçük, yan görünüm ve bulanık yüzlerde geliştirilmiş doğruluk. | Yüz özniteliklerini döndürmez. | Yüz işaretlerini döndürmez. |
| detection_03 | Şubat 2021'de yayımlandı ve isteğe bağlı olarak tüm yüz algılama işlemlerinde kullanılabilir. | Daha küçük yüzler (64x64 piksel) ve döndürülmüş yüz yönlendirmeleri de dahil olmak üzere daha fazla geliştirilmiş doğruluk. | Algılama çağrısında belirtilirse maske ve baş poz özniteliklerini döndürür. | Algılama çağrısında belirtilirse yüz yer işaretlerini döndürür. |
Algılama modellerinin performanslarını karşılaştırmanın en iyi yolu bunları örnek bir veri kümesinde kullanmaktır. Her algılama modelini kullanarak Yüz Tanıma - Algılama API'sini çeşitli görüntülerde, özellikle de çok sayıda yüzün veya görülmesi zor olan yüzlerin görüntüleri üzerinde çağırmanızı öneririz. Her modelin döndürdüğü yüz sayısına dikkat edin.
Belirtilen modele sahip yüzleri algılama
Yüz algılama, insan yüzlerinin sınırlayıcı kutu konumlarını bulur ve görsel yer işaretlerini tanımlar. Yüzün özelliklerini ayıklar ve daha sonra tanıma işlemlerinde kullanmak üzere depolar.
Yüz Tanıma - Algılama API'sini kullandığınızda, model sürümünü parametresiyle detectionModel atayabilirsiniz. Kullanılabilir değerler şunlardır:
detection_01detection_02detection_03
Yüz Tanıma - REST API'sini Algıla için bir istek URL'si şu şekilde görünür:
https://westus.api.cognitive.microsoft.com/face/v1.0/detect[?returnFaceId][&returnFaceLandmarks][&returnFaceAttributes][&recognitionModel][&returnRecognitionModel][&detectionModel]&subscription-key=<Subscription key>
İstemci kitaplığını kullanıyorsanız, uygun bir dize geçirerek değerini detectionModel atayabilirsiniz. Atanmamış olarak bırakırsanız, API varsayılan model sürümünü (detection_01 ) kullanır. .NET istemci kitaplığı için aşağıdaki kod örneğine bakın.
string imageUrl = "https://news.microsoft.com/ceo/assets/photos/06_web.jpg";
var faces = await faceClient.Face.DetectWithUrlAsync(url: imageUrl, returnFaceId: false, returnFaceLandmarks: false, recognitionModel: "recognition_04", detectionModel: "detection_03");
Belirtilen modele sahip kişiye yüz ekleme
Yüz Tanıma hizmeti, bir görüntüden yüz verilerini ayıklayabilir ve PersonGroup Kişisi - Yüz Ekleme API'si aracılığıyla bir Kişi nesnesiyle ilişkilendirebilir. Bu API çağrısında, algılama modelini Yüz Tanıma - Algılama ile aynı şekilde belirtebilirsiniz.
.NET istemci kitaplığı için aşağıdaki kod örneğine bakın.
// Create a PersonGroup and add a person with face detected by "detection_03" model
string personGroupId = "mypersongroupid";
await faceClient.PersonGroup.CreateAsync(personGroupId, "My Person Group Name", recognitionModel: "recognition_04");
string personId = (await faceClient.PersonGroupPerson.CreateAsync(personGroupId, "My Person Name")).PersonId;
string imageUrl = "https://news.microsoft.com/ceo/assets/photos/06_web.jpg";
await client.PersonGroupPerson.AddFaceFromUrlAsync(personGroupId, personId, imageUrl, detectionModel: "detection_03");
Bu kod, kimliği olan bir PersonGroup oluşturur ve buna bir Kişi ekler.mypersongroupid Ardından modeli kullanarak detection_03 bu Kişiye bir Yüz ekler. detectionModel parametresini belirtmezseniz, API varsayılan model detection_01olan kullanır.
Not
Bir Kişi nesnesindeki tüm yüzler için aynı algılama modelini kullanmanız gerekmez ve bir Kişi nesnesiyle karşılaştırmak için yeni yüzleri algılarken aynı algılama modelini kullanmanız gerekmez (örneğin Yüz Tanıma - Tanımlama API'sinde).
Belirtilen modelle FaceList'e yüz ekleme
Ayrıca, var olan bir FaceList nesnesine yüz eklediğinizde bir algılama modeli de belirtebilirsiniz. .NET istemci kitaplığı için aşağıdaki kod örneğine bakın.
await faceClient.FaceList.CreateAsync(faceListId, "My face collection", recognitionModel: "recognition_04");
string imageUrl = "https://news.microsoft.com/ceo/assets/photos/06_web.jpg";
await client.FaceList.AddFaceFromUrlAsync(faceListId, imageUrl, detectionModel: "detection_03");
Bu kod adlı My face collection bir FaceList oluşturur ve modelle buna detection_03 bir Yüz Ekler. detectionModel parametresini belirtmezseniz, API varsayılan model detection_01olan kullanır.
Not
Bir FaceList nesnesindeki tüm yüzler için aynı algılama modelini kullanmanız gerekmez ve bir FaceList nesnesiyle karşılaştırmak için yeni yüzleri algılarken aynı algılama modelini kullanmanız gerekmez.
Sonraki adımlar
Bu makalede, farklı Yüz Tanıma API'leriyle kullanılacak algılama modelini belirtmeyi öğrendiniz. Ardından, yüz algılama ve analize başlamak için hızlı başlangıcı izleyin.