Freigeben über

Face Recognition Operations - Group

  • Referenz
Dienst:
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.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

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

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Flow

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

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

Beispiele

Group Face IDs

Beispielanforderung

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

Beispiel für eine Antwort

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