Person Group Operations - Create Person Group Person

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

Belirtilen Kişi Grubunda yeni bir kişi oluşturun. Bu kişiye yüz eklemek için lütfen "Kişi Grubu Kişi Yüzü Ekle"yi arayın.

Not

    • Serbest katmanlı abonelik kotası:
      • Tüm Kişi Gruplarında 1.000 kişi.
    • S0 katmanlı abonelik kotası:
      • Kişi Grubu başına 10.000 kişi.
      • 1.000.000 Kişi Grubu.
      • Tüm Kişi Gruplarında 100.000.000 kişi.
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

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

CreatePersonResult

Başarılı bir çağrı, oluşturulan yeni bir personId 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

Create Person in PersonGroup

Örnek isteği

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

{
  "name": "your_person_group_person_name",
  "userData": "your_user_data"
}

Örnek yanıt

Durum kodu:
200 
{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}

Tanımlar

Name Description
CreatePersonResult

Oluşturma kişisinin 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.
FaceErrorResponse

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

CreatePersonResult

Oluşturma kişisinin yanıtı.

Name Tür Description
personId

string

Kişinin kişi kimliği.

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.