Large Person Group - Create

Kullanıcı tarafından belirtilen largePersonGroupId, name, isteğe bağlı userData ve recognitionModel ile yeni bir büyük kişi grubu oluşturun.
Büyük bir kişi grubu, yüz tanıma özelliği ve en fazla 1.000.000 kişi dahil olmak üzere karşıya yüklenen kişi verilerinin kapsayıcısıdır.
Oluşturduktan sonra, gruba kişi eklemek için LargePersonGroup Kişisi - Oluştur'u kullanın ve bu grubu Yüz Tanıma - Belirleme için hazırlamak üzere LargePersonGroup - Train çağrısı yapın.
Hiçbir görüntü depolanmaz. LargePersonGroup Person - Delete veya LargePersonGroup - Delete çağrılana kadar sunucuda yalnızca kişinin ayıklanan yüz özellikleri ve userData depolanır.
Bu büyük kişi grubuyla ilişkilendirmek için 'recognitionModel' belirtilmelidir. 'recognitionModel' için varsayılan değer 'recognition_01' değeridir. En son model gerekiyorsa lütfen bu parametrede ihtiyacınız olan modeli açıkça belirtin. Mevcut bir büyük kişi grubuna eklenen yeni yüzler, koleksiyonla zaten ilişkili olan tanıma modelini kullanır. Büyük bir kişi grubundaki mevcut yüz özellikleri, tanıma modelinin başka bir sürümü tarafından ayıklanan özelliklere güncelleştirilemez. Lütfen Yüz tanıma modeli belirtme bölümüne bakın.

Büyük kişi grubu kotası:

  • Ücretsiz katman abonelik kotası: 1.000 büyük kişi grubu.
  • S0 katmanlı abonelik kotası: 1.000.000 büyük kişi grubu.
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

URI Parametreleri

Name In Required Type Description
Endpoint
path True
  • string

Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve ana bilgisayar adı, örneğin: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Belirli bir büyük kişi grubuna başvuran kimlik.

Regex pattern: ^[a-z0-9-_]+$

İstek Başlığı

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

İstek Gövdesi

Name Required Type Description
name True
  • string

Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.

recognitionModel

Tanıma modelinin adı. Tanıma modeli, yüz özellikleri ayıklandığında ve algılanan faceId'ler, (Büyük)FaceList veya (Büyük)PersonGroup ile ilişkilendirildiğinde kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Oluşturma veya (Büyük)PersonGroup - Oluşturma işlemi gerçekleştirilirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'tir, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

userData
  • string

Kullanıcı verileri belirtti. Uzunluk 16 KB'ı geçmemelidir.

Yanıtlar

Name Type Description
200 OK

Başarılı bir çağrı boş bir yanıt gövdesi döndürür.

Other Status Codes

Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Örnekler

Create new large person group example

Sample Request

PUT {Endpoint}/face/v1.0/largepersongroups/abc


{
  "name": "large-person-group-name",
  "userData": "User-provided data attached to the large person group.",
  "recognitionModel": "recognition_01"
}

Sample Response

Tanımlar

APIError

API tarafından döndürülen hata bilgileri

Error

Hata gövdesi.

MetaDataContract

largePersonGroup/personGroup ve largeFaceList/faceList için kullanıcı tanımlı ad ve kullanıcı tarafından belirtilen veri ve tanıma modeli adı birleşimi.

RecognitionModel

Tanıma modelinin adı. Tanıma modeli, yüz özellikleri ayıklandığında ve algılanan faceId'ler, (Büyük)FaceList veya (Büyük)PersonGroup ile ilişkilendirildiğinde kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Oluşturma veya (Büyük)PersonGroup - Oluşturma işlemi gerçekleştirilirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'tir, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

APIError

API tarafından döndürülen hata bilgileri

Name Type Description
error

Hata gövdesi.

Error

Hata gövdesi.

Name Type Description
code
  • string
message
  • string

MetaDataContract

largePersonGroup/personGroup ve largeFaceList/faceList için kullanıcı tanımlı ad ve kullanıcı tarafından belirtilen veri ve tanıma modeli adı birleşimi.

Name Type Default Value Description
name
  • string

Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.

recognitionModel recognition_01

Tanıma modelinin adı. Tanıma modeli, yüz özellikleri ayıklandığında ve algılanan faceId'ler, (Büyük)FaceList veya (Büyük)PersonGroup ile ilişkilendirildiğinde kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Oluşturma veya (Büyük)PersonGroup - Oluşturma işlemi gerçekleştirilirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'tir, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

userData
  • string

Kullanıcı verileri belirtti. Uzunluk 16 KB'ı geçmemelidir.

RecognitionModel

Tanıma modelinin adı. Tanıma modeli, yüz özellikleri ayıklandığında ve algılanan faceId'ler, (Büyük)FaceList veya (Büyük)PersonGroup ile ilişkilendirildiğinde kullanılır. Yüz Tanıma - Algılama veya (Büyük)FaceList - Oluşturma veya (Büyük)PersonGroup - Oluşturma işlemi gerçekleştirilirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'tir, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

Name Type Description
recognition_01
  • string
recognition_02
  • string
recognition_03
  • string
recognition_04
  • string