Face Recognition Operations - Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Aday yüzleri yüz benzerliğine göre gruplara bölün.

• • Çıkış, bir veya daha fazla kopuk yüz grubu ve bir messyGroup şeklindedir. Yüz grubu, genellikle aynı kişinin benzer görünümlü yüzlerini içerir. 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şkili 'recognitionModel' faceId değerleri 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[]	"Detect" tarafından oluşturulan aday faceId dizisi. Maksimum yüz sayısı 1000'dir.

Yanıtlar

Name	Tür	Description
200 OK	GroupingResult	Başarılı bir çağrı, bir veya daha fazla benzer yüz grubu (grup boyutuna göre derece) ve bir messyGroup döndürür.
Other Status Codes	FaceErrorResponse	Beklenmeyen bir hata yanıtı. Headers x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure AI Yüz Tanıma aboneliğinizin gizli anahtarı.

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 Akışı

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Group Face IDs

Sample Request

HTTP

POST {endpoint}/face/v1.1-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"
  ]
}

Sample Response

Status code:

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 kapsamlı ayrıntılar 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

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar 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 okunabilen bir gösterimi.

FaceErrorResponse

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

Name	Tür	Description
error	FaceError	Hata nesnesi.

GroupingResult

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

Name	Tür	Description
groups	string[]	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[]	Orijinal yüzlerden benzer yüzleri bulamayan yüzlerin yüz kimlikleri dizisi.