Fonctionnement de l'API de reconnaissance faciale
Azure de Microsoft
1. Fonctionnement général de l'API Azure Face
a. Détection de visage :
- L'API reçoit une image (par URL ou upload).
- Elle identifie les visages humains présents dans l'image.
- Elle retourne des FaceIds temporaires, ainsi que des attributs faciaux (âge, émotions,
genre, lunettes, barbe, etc., si demandé).
b. Extraction des caractéristiques :
- Pour chaque visage détecté, Azure extrait des descripteurs numériques (appelés face
embeddings) représentant le visage.
- Ces embeddings sont des vecteurs mathématiques générés via un modèle
d’apprentissage profond.
2. Gestion des visages avec une base de données : les Person
Groups
a. Création d’un groupe de personnes :
- Tu crées un Person Group via l’API (/persongroups).
- Chaque personne dans ce groupe est ajoutée avec un ID unique (personId), et des
images de son visage.
b. Entraînement du modèle :
- Une fois les visages ajoutés, tu dois appeler l’API Train Person Group.
- Azure entraîne un modèle interne pour apprendre à reconnaître chaque personne du
groupe.
3. Comparaison d’un visage avec la base
Étapes :
1. Détecter le visage dans l'image :
- Envoie l’image à /detect pour obtenir un faceId.
2. Rechercher dans un Person Group :
- Utilise l’API /identify, en fournissant :
- Le faceId
- Le personGroupId
- Le nombre maximal de candidats à retourner
- Azure renvoie :
- Le(s) personId(s) correspondant(s) probables
- Un score de confiance (ex. : 0.92)
Action Endpoint REST
Détecter un visage POST /face/v1.0/detect
Créer un groupe PUT /face/v1.0/persongroups/{personGroupId}
Ajouter une personne POST /face/v1.0/persongroups/{personGroupId}/persons
Ajouter un visage POST /face/v1.0/persongroups/{personGroupId}/persons/{personId}/persisted
Entraîner le groupe POST /face/v1.0/persongroups/{personGroupId}/train
Identifier un visage POST /face/v1.0/identify
4. Sécurité et confidentialité
- Les faceIds sont temporaires (valables 24h).
- Les images ne sont pas stockées par défaut.
- Les données peuvent être cryptées et stockées dans ta propre infrastructure si tu veux
plus de contrôle.
- Microsoft respecte le RGPD et autres régulations (avec configurations régionales
possibles).
5. Endpoints REST courants
| Action | Endpoint REST |
|-----------------------------|----------------------------------------------------------------|
| Détecter un visage | POST /face/v1.0/detect |
| Créer un groupe | PUT /face/v1.0/persongroups/{personGroupId} |
| Ajouter une personne | POST /face/v1.0/persongroups/{personGroupId}/persons |
| Ajouter un visage | POST
/face/v1.0/persongroups/{personGroupId}/persons/{personId}/persistedFaces |
| Entraîner le groupe | POST /face/v1.0/persongroups/{personGroupId}/train |
| Identifier un visage | POST /face/v1.0/identify |
6. Exemples d’usage
- Contrôle d’accès (identifier un employé à l’entrée)
- Tri automatique de photos (grouper les visages similaires)
- KYC (Know Your Customer) pour les banques
- Sécurité et surveillance (identification de suspects)