Freigeben über

Face Recognition Operations - Group

  • Referenz
Dienst:
Azure AI Services
API-Version:
v1.2-preview.1

Dividieren Sie kandidatengesichtige Gesichter auf der Grundlage der Gesichtsähnlichkeit in Gruppen.

    • Die Ausgabe ist eine oder mehrere nicht zusammenhängende Gesichtsgruppen und eine unübersichtlicher Gruppe. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft der gleichen Person. Gesichtsgruppen werden nach Gruppengröße, d. h. anzahl der Gesichter, bewertet. Beachten Sie, dass Gesichter, die derselben Person angehören, möglicherweise in mehrere Gruppen im Ergebnis aufgeteilt werden.
    • MessyGroup ist eine spezielle Gesichtsgruppe mit Gesichtern, die keine ähnliche Gegenseite von originalen Gesichtern finden können. Die messyGroup wird nicht im Ergebnis angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
    • Die Gruppen-API benötigt mindestens 2 Kandidatensichten und höchstens 1000. Wir empfehlen, "Gesicht überprüfen" zu versuchen, wenn Sie nur zwei Kandidatengesichtsblätter haben.
    • Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte 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 (Rang nach Gruppengröße) und eine messyGroup zurück.
Other Status Codes

FaceErrorResponse

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

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

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 Face Service 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 Den Gruppensichtvorgang.

FaceError

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

Name Typ Beschreibung
code

string

Eine serverdefinierte Gruppe von Fehlercodes.
message

string

Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name Typ Beschreibung
error

FaceError

Das Fehlerobjekt.

GroupingResult

Antworttext für Den Gruppensichtvorgang.

Name Typ Beschreibung
groups

string[]

Eine Partition der ursprünglichen Gesichter auf der Grundlage der Gesichtsähnlichkeit. Gruppen werden nach Anzahl von Gesichtern bewertet.
messyGroup

string[]

Gesichts-IDs-Array von Gesichtern, die keine ähnlichen Gesichter aus originalen Gesichtern finden können.