Face List Operations - Create Face List

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Kullanıcı tarafından belirtilen faceListId, name, isteğe bağlı userData ve recognitionModel ile boş bir Yüz Listesi oluşturun.
Bir abonelikte en fazla 64 Yüz Tanıma Listesi'ne izin verilir.

Yüz Listesi, en fazla 1.000 yüz içeren bir yüz listesidir ve "Yüz Listesinden Benzerini Bul" tarafından kullanılır.

Oluşturma işleminden sonra, kullanıcı yüzleri içeri aktarmak için "Yüz Listesi Yüzü Ekle"yi kullanmalıdır. Hiçbir görüntü depolanmaz. "Yüz Listesini Sil" çağrılana kadar sunucuda yalnızca ayıklanan yüz özellikleri depolanır.

"Benzeri Bul", ünlü benzeri yüzleri bulma, benzer yüz filtreleme veya açık yönlü yüz belirleme gibi senaryolar için kullanılır. Ancak gerçek kullanım kişiyi tanımlamak içinse lütfen Kişi Grubu / Büyük Kişi Grubu ve "Tanımla" kullanın.

Yüz numarası büyük olduğunda lütfen Büyük Yüz Listesi'ni göz önünde bulundurun. En fazla 1.000.000 yüzü destekleyebilir.

PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}

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).
faceListId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Geçerli karakter küçük harf veya basamaklı harf ya da '-' veya '_', maksimum uzunluk 64'dür.

İstek Gövdesi

Name	Gerekli	Tür	Description
name	True	string minLength: 1 maxLength: 128	Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.
recognitionModel		RecognitionModel	Bu yüz listesiyle ilişkili 'recognitionModel'. Desteklenen 'recognitionModel' değerleri 'recognition_01', 'recognition_02, 'recognition_03' ve '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.
userData		string maxLength: 16384	İsteğe bağlı kullanıcı tanımlı veriler. Uzunluk 16K'yi aşmamalıdır.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarılı oldu.
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

Create FaceList

Örnek isteği

HTTP

PUT {endpoint}/face/v1.2/facelists/your_face_list_id

{
  "name": "your_face_list_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Örnek yanıt

Durum kodu:

200

Tanımlar

Name	Description
CreateCollectionRequest	Yüz koleksiyonu oluşturmaya yönelik model.
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.
RecognitionModel	Yüzün tanıma modeli.

CreateCollectionRequest

Object

Yüz koleksiyonu oluşturmaya yönelik model.

Name	Tür	Default value	Description
name	string minLength: 1 maxLength: 128		Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.
recognitionModel	RecognitionModel	recognition_01	Bu yüz listesiyle ilişkili 'recognitionModel'. Desteklenen 'recognitionModel' değerleri 'recognition_01', 'recognition_02, 'recognition_03' ve '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.
userData	string maxLength: 16384		İsteğe bağlı kullanıcı tanımlı veriler. Uzunluk 16K'yi aşmamalıdır.

FaceError

Object

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

Object

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

Name	Tür	Description
error	FaceError	Hata nesnesi.

RecognitionModel

Listeleme

Yüzün tanıma modeli.

Değer	Description
recognition_01	"Algıla" için varsayılan tanıma modeli. 2019 Mart'tan önce oluşturulan tüm bu faceId'ler bu tanıma modeliyle birleştirilmiştir.
recognition_02	2019 Mart ayında yayınlanan tanıma modeli.
recognition_03	2020 Mayıs ayında yayımlanan tanıma modeli.
recognition_04	Tanıma modeli 2021 Şubat'ta yayımlandı. Daha iyi tanıma doğruluğu için bu tanıma modelinin kullanılması önerilir.