Face Recognition Operations - Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Hiermit unterteilen Sie die Gesichter der Kandidaten basierend auf der Gesichterähnlichkeit in Gruppen.

• • Die Ausgabe ist eine oder mehrere unzusammengelöste Gesichtsgruppen und eine ungeordnete Gruppe. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft von derselben Person. Gesichtsgruppen werden nach Gruppengröße, d.h. der Anzahl der Gesichter, sortiert. Beachten Sie, dass Gesichter, die derselben Person gehören, im Ergebnis in mehrere Gruppen unterteilt werden können.
  • MessyGroup ist eine spezielle Gesichtsgruppe, die Gesichter enthält, die kein ähnliches Gegenstück von originalen Gesichtern finden können. Die messyGroup wird im Ergebnis nicht angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
  • Die Gruppen-API benötigt mindestens 2 Kandidaten gesichter und höchstens 1000. Es wird empfohlen, "Face to Face" zu überprüfen, wenn Sie nur 2 Kandidatengesichter haben.
  • Die faceIds "recognitionModel", die den FaceIds der Abfragegesichter zugeordnet sind, sollten identisch sein.

POST {endpoint}/face/{apiVersion}/group

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
apiVersion	path	True	string	API-Version
endpoint	path	True	string uri	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
faceIds	True	string[]	Array von Kandidaten-FaceIds, die von "Detect" erstellt wurden. Das Maximum beträgt 1000 Gesichter.

Antworten

Name	Typ	Beschreibung
200 OK	GroupingResult	Ein erfolgreicher Aufruf gibt eine oder mehrere Gruppen ähnlicher Gesichter (Rangfolge nach Gruppengröße) und eine messyGroup zurück.
Other Status Codes	FaceErrorResponse	Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Type: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Flow

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

Scopes

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

Beispiele

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"
  ]
}

Definitionen

Name	Beschreibung
FaceError	Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.
GroupingResult	Antworttext für gruppengesichtsvorgänge.

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Beschreibung
code	string	Einer der vom Server definierten Fehlercodes.
message	string	Eine für Menschen lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

GroupingResult

Antworttext für gruppengesichtsvorgänge.

Name	Typ	Beschreibung
groups	string[]	Eine Partition der ursprünglichen Gesichter basierend auf Gesichtsähnlichkeit. Gruppen werden nach der Anzahl der Gesichter sortiert.
messyGroup	string[]	Gesichts-ID-Array von Gesichtern, die keine ähnlichen Gesichter von ursprünglichen Gesichtern finden können.