Face Recognition Operations - Group

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Deel kandidaatgezichten in groepen op basis van gelijkenis met gezichten.

• • De uitvoer is een of meer niet-aaneengesloten gezichtsgroepen en een rommelige groep. Een gezichtsgroep bevat gezichten met een vergelijkbare blik, vaak van dezelfde persoon. Gezichtsgroepen worden gerangschikt op groepsgrootte, bijvoorbeeld het aantal gezichten. U ziet dat gezichten die tot dezelfde persoon behoren, mogelijk worden gesplitst in verschillende groepen in het resultaat.
  • MessyGroup is een speciale gezichtsgroep met gezichten die geen vergelijkbare tegenhanger van oorspronkelijke gezichten kunnen vinden. De rommeligeGroup 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 om 'Face to Face verifiëren' te proberen als u slechts twee 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 vergelijkbare gezichten (rangschikken op groepsgrootte) en een rommeligegroup.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten 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 Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Group Face IDs

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

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 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 met gezichten. Groepen worden gerangschikt op aantal gezichten.
messyGroup	string[]	Gezichts-id's matrix van gezichten die vergelijkbare gezichten van oorspronkelijke gezichten niet kunnen vinden.