Person Group Operations - Get Large Person Groups

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Tüm mevcut Büyük Kişi Gruplarının largePersonGroupId değerini, adını, userData ve recognitionModel'ini listeleyin.
Büyük Kişi Grupları, largePersonGroupId alfabetik sırada depolanır.

• • "start" parametresi (dize, isteğe bağlı), döndürülen girişlerin dize karşılaştırması temelinde daha büyük kimliklere sahip olacağı bir kimlik değeri belirtir. "start" değerinin boş bir değere ayarlanması, ilk öğeden başlayarak girişlerin döndürülmesi gerektiğini gösterir.
  • "top" parametresi (int, isteğe bağlı), çağrı başına en fazla 1000 giriş sınırıyla döndürülecek en fazla girdi sayısını belirler. Bu sınırı aşan ek girişleri almak için, geçerli çağrıda döndürülen son girişin personId değeriyle "start" değerini belirtin.

Bahşiş

• Örneğin, kimlikleriyle birlikte toplam 5 öğe vardır: "itemId1", ..., "itemId5".
  • "start=&top=" 5 öğenin tümünü döndürür.
  • "start=&top=2", "itemId1", "itemId2" döndürür.
  • "start=itemId2&top=3", "itemId3", "itemId4", "itemId5" döndürür.

GET {endpoint}/face/{apiVersion}/largepersongroups

İsteğe bağlı parametrelerle:

GET {endpoint}/face/{apiVersion}/largepersongroups?start={start}&top={top}&returnRecognitionModel={returnRecognitionModel}

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).
returnRecognitionModel	query		boolean	'recognitionModel' döndür veya döndürme. Varsayılan değer false'tur.
start	query		string	"Başlangıç" değerinden büyük kaynakları listeleyin. En fazla 64 karakter içerir. Varsayılan boş.
top	query		integer (int32) minimum: 1 maximum: 1000	[1, 1000] ile değişen, listelenmesi gereken öğe sayısı. Varsayılan değer 1000'dir.

Yanıtlar

Name	Tür	Description
200 OK	LargePersonGroup[]	Başarılı bir çağrı, Büyük Kişi Grupları ve bilgilerini (largePersonGroupId, name ve userData) içeren bir dizi döndürür.
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

Get LargePersonGroups

Örnek isteği

HTTP

GET {endpoint}/face/v1.2/largepersongroups?start=00000000-0000-0000-0000-000000000000&top=20&returnRecognitionModel=True

Örnek yanıt

Durum kodu:

200

[
  {
    "name": "your_large_person_group_name",
    "userData": "your_user_data",
    "recognitionModel": "recognition_01",
    "largePersonGroupId": "your_large_person_group_id"
  }
]

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.
LargePersonGroup	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ı.
RecognitionModel	Yüzün tanıma modeli.

FaceError

Object

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

Object

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

Name	Tür	Description
error	FaceError	Hata nesnesi.

LargePersonGroup

Object

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ı.

Name	Tür	Description
largePersonGroupId	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Kapsayıcının kimliği.
name	string minLength: 1 maxLength: 128	Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.
recognitionModel	RecognitionModel	Tanıma modelinin adı. Tanıma modeli, yüz özellikleri ayıklandığında ve algılanan faceId'lerle ilişkilendirildiğinde kullanılır.
userData	string maxLength: 16384	İsteğe bağlı kullanıcı tanımlı veriler. Uzunluk 16K'yi aşmamalıdır.

RecognitionModel

Listeleme

Yüzün tanıma modeli.

Değer	Description
recognition_01	"Algıla" için varsayılan tanıma modeli. 2019 Mart'tan önce oluşturulan tüm bu faceId'ler bu tanıma modeliyle birleştirilmiştir.
recognition_02	2019 Mart ayında yayınlanan tanıma modeli.
recognition_03	2020 Mayıs ayında yayımlanan tanıma modeli.
recognition_04	Tanıma modeli 2021 Şubat'ta yayımlandı. Daha iyi tanıma doğruluğu için bu tanıma modelinin kullanılması önerilir.