Face List Operations - Add Large Face List Face From Url

  • Başvuru
Hizmet:
Azure AI Services
API Sürümü:
v1.2-preview.1

Belirtilen Büyük Yüz Listesi'ne 1.000.000'e kadar 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 Yüz Listesi Yüzünü Sil" veya "Büyük Yüz Listesini 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

Not

    • 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/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces
İsteğe bağlı parametrelerle: 
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces?targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

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).
largeFaceListId
 path True

string

Geçerli karakter küçük harf veya basamaklı harf ya da '-' veya '_', maksimum uzunluk 64'dür.

Normal ifade deseni: ^[a-z0-9-_]+$
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'.
targetFace
 query

integer[]

Bir kişiye eklenecek hedef yüzü belirtmek için 'targetFace=left,top,width,height' biçiminde bir yüz dikdörtgeni.
userData
 query

string

Yüze eklenen kullanıcı tarafından sağlanan veriler. Boyut sınırı 1K'dır.

İstek Gövdesi

Name Gerekli Tür Description
url True

string

Giriş görüntüsünün URL'si.

Yanıtlar

Name Tür Description
200 OK

AddFaceResult

Başarılı bir çağrı yeni bir persistedFaceId döndürür.
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

Add Face to LargeFaceList from Url

Örnek isteği

POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/persistedfaces?targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

Örnek yanıt

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

Tanımlar

Name Description
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.

AddFaceResult

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

Name Tür Description
persistedFaceId

string

Kalıcı hale gelen ve süresi dolmayan eklenen yüzün Kalıcı Yüz Kimliği. "Algıla" içinde oluşturulan ve algılama çağrısından sonraki 24 saat içinde süresi dolacak faceId'den farklıdır.

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

Name Tür Description
detection_01

string

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

string

Ö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

string

2021 Şubat ayında kullanıma sunulan algılama modeli, özellikle küçük yüzlerde iyileştirilmiş doğrulukla.

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.

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

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

Name Tür Description
error

FaceError

Hata nesnesi.