Large Face List - Add Face From Stream

Hizmet:

Azure AI Services

API Sürümü:

1.0

Belirtilen büyük yüz listesine en çok 1.000.000 yüz içeren bir yüz ekleyin.
Bir görüntüyle ilgilenmek için birden çok yüz içeren 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. LargeFaceList Yüz Tanıma - Sil veya LargeFaceList Sil - sil çağrılana kadar yalnızca ayıklanan yüz özelliği sunucuda depolanır.
Kalıcı OlanFaceId değerinin Face - Detecttarafından oluşturulan faceId'den farklı olduğuna dikkat edin.

• 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.
• 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 Yüz Tanıma -Algıla'dan döndürülmezse, yüzü başarıyla algılama ve ekleme 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.
• Aynı yüz listesine yüz ekleme/silme sıralı olarak işlenir ve farklı yüz listelerine/bu listelerden gelen yüzler paralel olarak işlenir.
• 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 bir algılama modeli belirtme bölümüne bakın.

Kota:

• Serbest katman abonelik kotası: Büyük yüz listesi başına 1.000 yüz.
• S0 katmanlı abonelik kotası: Büyük yüz listesi başına 1.000.000 yüz.

POST {Endpoint}/face/v1.0/largefacelists/{largeFaceListId}/persistedfaces

İsteğe bağlı parametrelerle:

POST {Endpoint}/face/v1.0/largefacelists/{largeFaceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
Endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://westus.api.cognitive.microsoft.com).
largeFaceListId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	Belirli bir büyük yüz listesine başvuran kimlik.
detectionModel	query		DetectionModel	Algılama modelinin adı. Algılama modeli, gönderilen görüntüdeki yüzleri algılamak için kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Yüz Ekle veya (Büyük)PersonGroup - Yüz Ekle işlemi gerçekleştirilirken bir algılama modeli adı sağlanabilir. Varsayılan değer 'detection_01'dır, başka bir model gerekiyorsa lütfen açıkça belirtin.
targetFace	query		integer[]	Bir kişiye eklenecek hedef yüzü "targetFace=left,top,width,height" biçiminde belirtmek için bir yüz dikdörtgeni. Örneğin, "targetFace=10,10,100,100". Görüntüde birden fazla yüz varsa, eklenecek yüzü belirtmek için targetFace gereklidir. TargetFace yok, görüntünün tamamında algılanan tek bir yüz olduğu anlamına gelir.
userData	query		string maxLength: 1024	Herhangi bir amaçla yüzle ilgili kullanıcı tarafından belirtilen veriler. Maksimum uzunluk 1 KB'tır.

İstek Başlığı

Media Types: "application/octet-stream"

Name	Gerekli	Tür	Description
Ocp-Apim-Subscription-Key	True	string

İstek Gövdesi

Media Types: "application/octet-stream"

Name	Tür	Description
Image	object (file)	Bir görüntü akışı.

Yanıtlar

Name	Tür	Description
200 OK	PersistedFace	Başarılı bir çağrı yeni bir persistedFaceId döndürür.
Other Status Codes	APIError	Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Örnekler

Add face to large face list from stream example

Örnek isteği

HTTP

POST {Endpoint}/face/v1.0/largefacelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Örnek yanıt

Durum kodu:

200

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Tanımlar

Name	Description
APIError	API tarafından döndürülen hata bilgileri
DetectionModel	Algılama modelinin adı. Algılama modeli, gönderilen görüntüdeki yüzleri algılamak için kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Yüz Ekle veya (Büyük)PersonGroup - Yüz Ekle işlemi gerçekleştirilirken bir algılama modeli adı sağlanabilir. Varsayılan değer 'detection_01'dır, başka bir model gerekiyorsa lütfen açıkça belirtin.
Error	Hata gövdesi.
PersistedFace	PersonFace nesnesi.

APIError

Object

API tarafından döndürülen hata bilgileri

Name	Tür	Description
error	Error	Hata gövdesi.

DetectionModel

Listeleme

Algılama modelinin adı. Algılama modeli, gönderilen görüntüdeki yüzleri algılamak için kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Yüz Ekle veya (Büyük)PersonGroup - Yüz Ekle işlemi gerçekleştirilirken bir algılama modeli adı sağlanabilir. Varsayılan değer 'detection_01'dır, başka bir model gerekiyorsa lütfen açıkça belirtin.

Değer	Description
detection_01
detection_02
detection_03

Error

Object

Hata gövdesi.

Name	Tür	Description
code	string
message	string

PersistedFace

Object

PersonFace nesnesi.

Name	Tür	Description
persistedFaceId	string (uuid)	Kalıcı olan ve süresi dolmayan hedef yüzün persistedFaceId değeri. Face tarafından oluşturulan faceId'den farklı - Algılama çağrısından sonra faceIdTimeToLive tarafından belirtilen zamanda algılama ve süresi dolacak.
userData	string maxLength: 1024	Yüze eklenen kullanıcı tarafından sağlanan veriler. Boyut sınırı 1 KB'tır.