Face Recognition Operations - Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Deel gezichten van kandidaten in groepen op basis van gelijkenis van gezichten.

• • De uitvoer is een of meer niet-aaneengesloten gezichtsgroepen en een messyGroup. Een gezichtsgroep bevat gezichten die er vergelijkbaar uitzien, vaak van dezelfde persoon. Gezichtsgroepen worden gerangschikt op groepsgrootte, dat wil zeggen het aantal gezichten. U ziet dat gezichten die tot dezelfde persoon behoren, in het resultaat kunnen worden gesplitst in verschillende groepen.
  • MessyGroup is een speciale gezichtsgroep met gezichten die geen vergelijkbare tegenhanger van de oorspronkelijke gezichten kunnen vinden. De messyGroup wordt niet weergegeven in het resultaat als alle gezichten hun tegenhangers hebben gevonden.
  • Groeps-API heeft ten minste 2 kandidaat-gezichten en maximaal 1000 nodig. We raden u aan 'Face To Face verifiëren' te proberen wanneer u slechts 2 kandidaat-gezichten hebt.
  • Het 'recognitionModel' dat is gekoppeld aan de faceIds van de querygezichten, moet hetzelfde zijn.

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

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol- en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

Aanvraagbody

Name	Vereist	Type	Description
faceIds	True	string[]	Matrix van kandidaat-faceIds die zijn gemaakt door 'Detect'. Het maximum is 1000 gezichten.

Antwoorden

Name	Type	Description
200 OK	GroupingResult	Een geslaagde aanroep retourneert een of meer groepen met vergelijkbare gezichten (rangschikken op groepsgrootte) en een rommelige Groep.
Other Status Codes	FaceErrorResponse	Een onverwacht foutbericht. Headers x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De OAuth2-stroom van Azure Active Directory

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

Voorbeelden

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

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
GroupingResult	Antwoordtekst voor groepszichtbewerking.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een door mensen leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

GroupingResult

Antwoordtekst voor groepszichtbewerking.

Name	Type	Description
groups	string[]	Een partitie van de oorspronkelijke gezichten op basis van gelijkenis van gezichten. Groepen worden gerangschikt op aantal gezichten.
messyGroup	string[]	Gezichts-id's matrix van gezichten die geen vergelijkbare gezichten van de oorspronkelijke gezichten kunnen vinden.