Partager via

Face Recognition Operations - Identify From Person Group

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Identification 1 à plusieurs pour trouver les correspondances les plus proches de la personne de requête spécifique à partir d’un groupe de personnes.
Pour chaque visage du tableau faceIds, Face Identifier calcule les similitudes entre le visage de la requête et tous les visages du groupe de personnes (donnés par personGroupId) et retourne la ou les personnes candidates pour ce visage classés par confiance en similarité. Le groupe de personnes doit être formé pour le préparer à l’identification. Pour plus d’informations, consultez « Entraîner le groupe de personnes ».

Note

    • L’algorithme permet à plusieurs visages d’être identifiés indépendamment à la même demande, mais pas plus de 10 visages.
    • Chaque personne pourrait avoir plus d’un visage, mais pas plus de 248 visages.
    • Une meilleure qualité d’image de visage signifie une meilleure précision d’identification. Tenez compte des visages de haute qualité : la taille frontale, claire et faciale est de 200 x 200 pixels (100 pixels entre les yeux) ou plus.
    • Le nombre de candidats retournés est limité par maxNumOfCandidatesReturned et confidenceThreshold. Si aucune personne n’est identifiée, les candidats retournés sont un tableau vide.
    • Essayez « Rechercher similaire » lorsque vous devez rechercher des visages similaires à partir d’une liste de visages/d’une liste de visages volumineuses au lieu d’un groupe de personnes.
    • Les faceIds « recognitionModel » associés aux visages de requête doivent être identiques au « recognitionModel » utilisé par le groupe de personnes cible.
POST {endpoint}/face/{apiVersion}/identify

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 visages des visages de requête, créé par « Detect ». Chacun des visages est identifié indépendamment. Le nombre valide de faceIds est compris entre [1, 10].
personGroupId True

string

personGroupId du groupe de personnes cible, créé par « Créer un groupe de personnes ». Les paramètres personGroupId et largePersonGroupId ne doivent pas être fournis en même temps.
confidenceThreshold

number

Seuil de confiance d’identification personnalisé, dans la plage de [0, 1]. L’utilisateur avancé peut ajuster cette valeur pour remplacer le seuil interne par défaut pour une meilleure précision sur ses données de scénario. Notez qu’il n’existe aucune garantie de cette valeur de seuil travaillant sur d’autres données et après les mises à jour de l’algorithme.
maxNumOfCandidatesReturned

integer

La plage de maxNumOfCandidatesReturned est comprise entre 1 et 100. La valeur par défaut est 10.

Réponses

Nom Type Description
200 OK

IdentificationResult[]

Un appel réussi retourne la ou les personnes candidates identifiées pour chaque visage de requête.
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

Identify from PersonGroup

Exemple de requête

POST {endpoint}/face/v1.2-preview.1/identify

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Exemple de réponse

Code d’état:
200 
[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

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.
IdentificationCandidate

Candidat à l’appel d’identification.
IdentificationResult

Identifiez le résultat.

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.

IdentificationCandidate

Candidat à l’appel d’identification.

Nom Type Description
confidence

number

Valeur de confiance du candidat. Plus la confiance est élevée, plus elle est similaire. Plage comprise entre [0,1].
personId

string

personId de la personne candidate.

IdentificationResult

Identifiez le résultat.

Nom Type Description
candidates

IdentificationCandidate[]

Candidats identifiés pour ce visage (classés par confiance). La taille du tableau ne doit pas être supérieure à l’entrée maxNumOfCandidatesReturned. Si aucune personne n’est identifiée, retourne un tableau vide.
faceId

string

faceId du visage de la requête.