Aracılığıyla paylaş

Face Recognition Operations - Group

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

Aday yüzlerini yüz benzerliğine göre gruplara ayırın.

    • Çıkış, bir veya daha fazla kopuk yüz grubu ve bir messyGroup şeklindedir. Yüz grubu, benzer görünümlü yüzler içerir ve genellikle aynı kişiye ait olur. Yüz grupları grup boyutuna göre (örneğin yüz sayısına) göre sıralanır. Aynı kişiye ait yüzlerin sonuçta birkaç gruba ayrılabileceğine dikkat edin.
    • MessyGroup, özgün yüzlerden benzer bir karşılık gelen yüzü bulamayan yüzler içeren özel bir yüz grubudur. Tüm yüzler karşılık gelenlerini bulursa messyGroup sonuçta görünmez.
    • Grup API'sinde en az 2 aday yüzü ve en fazla 1000 aday yüzü gerekir. Yalnızca 2 aday yüzünüz olduğunda "Yüz Yüze Doğrula" seçeneğini denemenizi öneririz.
    • Sorgu yüzleriyle ilişkilendirilmiş 'recognitionModel' faceId'leri aynı olmalıdır.
POST {endpoint}/face/{apiVersion}/group

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

İstek Gövdesi

Name Gerekli Tür Description
faceIds True

string[] (uuid)

"Detect" tarafından oluşturulan aday faceId dizisi. En fazla 1000 yüz.

Yanıtlar

Name Tür Description
200 OK

GroupingResult

Başarılı bir çağrı, benzer yüzlerden oluşan bir veya daha fazla grup (grup boyutuna göre derece) ve bir messyGroup 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

Group Face IDs

Örnek isteği

POST {endpoint}/face/v1.2-preview.1/group

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

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

Grup yüzü işlemi için yanıt gövdesi.

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.

GroupingResult

Object

Grup yüzü işlemi için yanıt gövdesi.

Name Tür Description
groups

string[] (uuid)

Yüz benzerliğine göre özgün yüzlerin bölümü. Gruplar yüz sayısına göre sıralanır.
messyGroup

string[] (uuid)

Orijinal yüzlerden benzer yüzleri bulamayan yüzlerin yüz kimlikleri dizisi.