Person Group Operations - Add Large Person Group Person Face

Yüz belirleme veya doğrulama için Büyük Kişi Grubuna bir kişiye yüz ekleyin.
Birden çok yüz içeren bir görüntüyle başa çıkmak için, giriş yüzü targetFace dikdörtgeni olan bir görüntü olarak belirtilebilir. Eklenen yüzü temsil eden kalıcı birFaceId döndürür. Hiçbir görüntü depolanmaz. "Büyük Kişi Grubu Kişi Yüzünü Sil", "Büyük Kişi Grubu Kişisini Sil" veya "Büyük Kişi Grubunu Sil" çağrılana kadar sunucuda yalnızca ayıklanan yüz özellikleri depolanır.

KalıcıFaceId değerinin "Detect" tarafından oluşturulan faceId'den farklı olduğunu unutmayın.

• • Daha yüksek yüz görüntüsü kalitesi, daha iyi tanıma duyarlığı anlamına gelir. Lütfen yüksek kaliteli yüzleri göz önünde bulundurun: ön, net ve yüz boyutu 200x200 piksel (gözler arasında 100 piksel) veya daha büyük.
  • Her kişi girişi en fazla 248 yüz barındırabilir.
  • 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.
  • "targetFace" dikdörtgeni tek bir yüz içermelidir. Sıfır veya birden çok yüz hata olarak kabul edilir. Sağlanan "targetFace" dikdörtgeni "Detect" içinden döndürülmezse, yüzü başarıyla algılamanın ve eklemenin garantisi yoktur.
  • Algılanabilir yüz boyutu (36x36 - 4096x4096 piksel), büyük baş pozu veya büyük tıkanıklıklar hatalara neden olur.
  • 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.
  • Farklı 'detectionModel' değerleri sağlanabilir. Farklı algılama modellerini kullanmak ve karşılaştırmak için lütfen https://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?_overload=addLargePersonGroupPersonFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

URI Parametreleri

İstek Gövdesi

Media Types: "application/octet-stream"

Yanıtlar

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

Örnekler

Add Face in LargePersonGroup Person

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?_overload=addLargePersonGroupPersonFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Tanımlar

AddFaceResult

Yüz eklemek için yanıt gövdesi.

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'.

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.