Face Recognition Operations - Group

  • Référence
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

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.