Aracılığıyla paylaş


Large Person Group - List

Var olan tüm büyük kişi gruplarının largePersonGroupId, name, userData ve recognitionModel bilgilerini listeleyin.

  • Büyük kişi grupları, büyükPersonGroupId alfabetik sırada depolanır.
  • "start" parametresi (dize, isteğe bağlı), döndürülen girişlerin dize karşılaştırması tarafından daha büyük kimliklere sahip olduğu kullanıcı tarafından sağlanan bir largePersonGroupId değeridir. İlk öğeden dönüş belirtmek için "start" boş olarak ayarlanır.
  • "top" parametresi (int, isteğe bağlı) döndürülecek girdi sayısını belirtir. Bir çağrıda en fazla 1000 giriş döndürülebilir. Daha fazlasını getirmek için, son döndürülen girişin geçerli çağrı kimliğiyle "başlat" belirtebilirsiniz.
    Örneğin, toplam 5 büyük kişi grubu: "group1", ..., "group5".
    "start=&top=" 5 grubun tümünü döndürür.
    "start=&top=2", "group1", "group2" döndürür.
    "start=group2&top=3", "group3", "group4", "group5" döndürür.
GET {Endpoint}/face/v1.0/largepersongroups
GET {Endpoint}/face/v1.0/largepersongroups?start={start}&top={top}&returnRecognitionModel={returnRecognitionModel}

URI Parametreleri

Name İçinde Gerekli Tür Description
Endpoint
path True

string

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

returnRecognitionModel
query

boolean

İşlemin yanıt olarak 'recognitionModel' döndürerek döndürmeyeceğini belirten bir değer.

start
query

string

"start" değerinden büyük olan en küçük largePersonGroupId değerinden büyük kişi gruplarını listeleyin.

top
query

integer

Listelenecek büyük kişi gruplarının sayısı.

İstek Başlığı

Name Gerekli Tür Description
Ocp-Apim-Subscription-Key True

string

Yanıtlar

Name Tür Description
200 OK

LargePersonGroup[]

Başarılı bir çağrı, büyük kişi gruplarını ve bilgilerini içeren bir dizi döndürür.

Other Status Codes

APIError

Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Örnekler

List large person groups example

Örnek isteği

GET {Endpoint}/face/v1.0/largepersongroups?start=sample_group&top=2&returnRecognitionModel=True

Örnek yanıt

[
  {
    "largePersonGroupId": "f92f6f1b-3258-4444-8fa2-c2df505cc7ac",
    "name": "large-person-group-name1",
    "userData": "User-provided data attached to the large person group.",
    "recognitionModel": "recognition_01"
  },
  {
    "largePersonGroupId": "c76f7f13-0ed3-4d00-8a3e-2ad3d78f6c37",
    "name": "large-person-group-name2",
    "userData": "User-provided data attached to the large person group.",
    "recognitionModel": "recognition_01"
  }
]

Tanımlar

Name Description
APIError

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

Error

Hata gövdesi.

LargePersonGroup

Büyük kişi grubu nesnesi.

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 - İçerik Oluşturucu veya (Büyük)PersonGroup - İçerik Oluşturucu gerçekleştirirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'dır, 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 Tür Description
error

Error

Hata gövdesi.

Error

Hata gövdesi.

Name Tür Description
code

string

message

string

LargePersonGroup

Büyük kişi grubu nesnesi.

Name Tür Default value Description
largePersonGroupId

string

Hedef büyük kişi gruplarının LargePersonGroupId değeri

name

string

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

recognitionModel

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 - İçerik Oluşturucu veya (Büyük)PersonGroup - İçerik Oluşturucu gerçekleştirirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'dır, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

userData

string

Kullanıcı tarafından belirtilen veriler. Uzunluk 16 KB'ı aşmamalıdır.

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 - İçerik Oluşturucu veya (Büyük)PersonGroup - İçerik Oluşturucu gerçekleştirirken bir tanıma modeli adı sağlanabilir. Varsayılan değer 'recognition_01'dır, en son model gerekiyorsa lütfen ihtiyacınız olan modeli açıkça belirtin.

Name Tür Description
recognition_01

string

recognition_02

string

recognition_03

string

recognition_04

string