Face Recognition Operations - Identify From Person Directory

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Identification 1 à plusieurs pour rechercher les correspondances les plus proches du visage de la personne de requête spécifique à partir d’un tableau personIds d’annuaire de personnes.
Pour chaque visage dans le tableau faceIds, Face Identifier calcule les similitudes entre le visage de la requête et tous les visages dans les personnes de l’annuaire de personnes (données par personIds) et retourne la ou les personnes candidates pour ce visage classés par confiance en similarité. Le passage de personIds avec un tableau avec un élément « * » peut effectuer l’opération sur l’ensemble du répertoire de la personne.

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.
  • L’opération Identifier ne peut correspondre qu’aux visages obtenus avec le même modèle de reconnaissance, associé aux visages de requête.

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].
personIds	True	string[]	Tableau de personIds créés dans l’annuaire de personnes « Créer une personne ». Le nombre valide de personIds est compris entre [1,30].
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 PersonDirectory

Exemple de requête

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ],
  "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.