Person Group Operations - Create Person Group

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

Belirtilen personGroupId, name, user tarafından sağlanan userData ve recognitionModel ile yeni bir Kişi Grubu oluşturun.
Kişi Grubu, yüz tanıma özellikleri de dahil olmak üzere karşıya yüklenen kişi verilerini tutan bir kapsayıcıdır.

Oluşturma işleminden sonra gruba kişi eklemek için "Kişi Grubu Kişisi Oluştur"u 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 Bir 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 Grubu. Her birinde en fazla 1.000 kişi vardır.
    • S0 katmanlı abonelik kotası: 1.000.000 Kişi Grubu. Her birinde en fazla 10.000 kişi vardır.
    • daha büyük ölçekli yüz tanıma sorununu çözmek için lütfen Büyük Kişi Grubunu 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.

Normal ifade deseni: ^[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 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 PersonGroup

Örnek isteği

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

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

Örnek yanıt

Durum kodu:
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 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.

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.