Person Group Operations - Get Person Group Person Face

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Kişi yüz bilgilerini alma. Kalıcı kişi yüzü, personGroupId, personId ve persistedFaceId ile belirtilir.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}

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).
persistedFaceId	path	True	string (uuid)	Yüzün yüz kimliği.
personGroupId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Kapsayıcının kimliği.
personId	path	True	string (uuid)	Kişinin kimliği.

Yanıtlar

Name	Tür	Description
200 OK	PersonGroupPersonFace	Başarılı bir çağrı, hedef kalıcı yüzün bilgilerini (persistedFaceId ve userData) 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 Face form PersonGroup Person

Örnek isteği

HTTP

GET {endpoint}/face/v1.2/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Örnek yanıt

Durum kodu:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

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.
PersonGroupPersonFace	Kişi grubu kişisi için yüz kaynağı.

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.

PersonGroupPersonFace

Object

Kişi grubu kişisi için yüz kaynağı.

Name	Tür	Description
persistedFaceId	string (uuid)	Yüzün yüz kimliği.
userData	string maxLength: 1024	Yüze eklenen kullanıcı tarafından sağlanan veriler. Uzunluk sınırı 1K'dır.