Person Group Operations - Create Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Belirtilen personGroupId, name, user-provided userData ve recognitionModel ile yeni bir Kişi Grubu İçerik Oluşturucu.
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.

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

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

Bu 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 Kişi Grubuna eklenen yeni yüzler, koleksiyonla zaten ilişkili olan tanıma modelini kullanır. 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 Kişi Gruplar. Her birinde en fazla 1000 kişi vardır.
  • S0 katmanlı abonelik kotası: 1.000.000 Kişi Gruplar. Her birinde en fazla 10.000 kişi bulunur.
  • daha büyük ölçekli yüz tanımlama sorununu çözmek için lütfen Büyük Kişi Grubu kullanmayı göz önünde bulundurun.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

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).
personGroupId	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 PersonGroup

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id

{
  "name": "your_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.