Person Group Operations - Create Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Kullanıcı tarafından belirtilen largePersonGroupId, name, isteğe bağlı userData ve recognitionModel ile yeni bir Büyük Kişi Grubu İçerik Oluşturucu.
Büyük Kişi Grubu, yüz tanıma özellikleri de dahil olmak üzere karşıya yüklenen kişi verilerini içeren bir kapsayıcıdır. En fazla 1.000.000 varlığı barındırabilir.

Oluşturulduktan sonra, gruba kişi eklemek için "Büyük Kişi Grubu Kişisi İçerik Oluşturucu" kullanın ve bu grubu "Büyük Kişi Grubundan Tanımla" için hazırlamak üzere "Büyük Kişi Grubunu Eğit" çağrısı yapın.

Hiçbir görüntü depolanmaz. "Büyük Kişi Grubunu Sil" veya "Büyük Kişi Grubunu Sil" çağrılana kadar sunucuda yalnızca kişinin ayıklanan yüz özellikleri ve userData depolanır.

Bu Büyük Kişi Grubu ile ilişkilendirmek için 'recognitionModel' belirtilmelidir. 'recognitionModel' için varsayılan değer 'recognition_01' şeklindedir. En son model gerekiyorsa lütfen bu parametrede ihtiyacınız olan modeli açıkça belirtin. Mevcut Büyük Kişi Grubuna eklenen yeni yüzler, koleksiyonla zaten ilişkili olan tanıma modelini kullanır. Büyük Kişi Grubundaki mevcut yüz özellikleri, tanıma modelinin başka bir sürümü tarafından ayıklanan özelliklere güncelleştirilemez.

Not

• • Ücretsiz katman abonelik kotası: 1.000 Büyük Kişi Gruplar.
  • S0 katmanlı abonelik kotası: 1.000.000 Büyük Kişi Gruplar.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

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).
largePersonGroupId	path	True	string	Kapsayıcının kimliği. Regex pattern: ^[a-z0-9-_]+$

İstek Gövdesi

Name	Gerekli	Tür	Description
name	True	string	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	İsteğe bağlı kullanıcı tanımlı veriler. Uzunluk 16 bini geçmemelidir.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarılı oldu.
Other Status Codes	FaceErrorResponse	Beklenmeyen bir hata yanıtı. Headers x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure AI Yüz Tanıma aboneliğinizin gizli anahtarı.

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 Akışı

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Create LargePersonGroup

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id

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

Sample Response

Status code:

200

Tanımlar

Name	Description
FaceError	Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar 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.

FaceError

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar 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 okunabilen bir gösterimi.

FaceErrorResponse

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

Name	Tür	Description
error	FaceError	Hata nesnesi.