Face Recognition Operations - Group

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Divisez les visages candidats en groupes en fonction de la similarité des visages.

• • La sortie est un ou plusieurs groupes de visages disjoints et un messyGroup. Un groupe de visages contient des visages qui ont une apparence similaire, souvent de la même personne. Les groupes de visages sont classés par taille de groupe, c’est-à-dire le nombre de visages. Notez que les visages appartenant à une même personne peuvent être divisés en plusieurs groupes dans le résultat.
  • MessyGroup est un groupe de visages spécial contenant des visages qui ne trouvent aucun visage équivalent similaire des visages d’origine. Le messyGroup n’apparaît pas dans le résultat si tous les visages ont trouvé leurs équivalents.
  • L’API de groupe a besoin d’au moins 2 visages candidats et 1 000 au maximum. Nous vous suggérons d’essayer « Vérifier face à face » lorsque vous n’avez que 2 visages candidats.
  • Les faceIds « recognitionModel » associés aux visages de requête doivent être identiques.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version de l’API
endpoint	path	True	string uri	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).

Corps de la demande

Nom	Obligatoire	Type	Description
faceIds	True	string[]	Tableau de faceIds candidats créés par « Detect ». La valeur maximale est de 1 000 visages.

Réponses

Nom	Type	Description
200 OK	GroupingResult	Un appel réussi retourne un ou plusieurs groupes de visages similaires (classés par taille de groupe) et un messyGroup.
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

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

Exemples

Group Face IDs

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
FaceError	Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Réponse contenant les détails de l’erreur.
GroupingResult	Corps de la réponse pour l’opération de visage de groupe.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
message	string	Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	FaceError	Objet d’erreur.

GroupingResult

Corps de la réponse pour l’opération de visage de groupe.

Nom	Type	Description
groups	string[]	Partition des visages originaux en fonction de la similarité des visages. Les groupes sont classés par nombre de visages.
messyGroup	string[]	Tableau d’ids de visages de visages qui ne peuvent pas trouver de visages similaires à partir de visages d’origine.