Face Recognition Operations - Identify From Large Person Group
Identification 1 à plusieurs pour trouver les correspondances les plus proches du visage de la personne de requête spécifique à partir d’un groupe de personnes volumineuses.
Pour chaque visage dans le tableau faceIds, Face Identifier calcule les similitudes entre le visage de la requête et tous les visages du groupe de grandes personnes (donnés par largePersonGroupId) et retourne la ou les personnes candidates pour ce visage classés par confiance en similarité. Le grand groupe de personnes doit être formé pour le préparer à l’identification. Pour plus d’informations, consultez « Entraîner un grand groupe de personnes ».
Notes
-
- L’algorithme permet d’identifier plusieurs visages indépendamment à la même demande, mais pas plus de 10 visages.
- Chaque personne peut avoir plusieurs visages, mais pas plus de 248 visages.
- Une meilleure qualité d’image du visage signifie une meilleure précision d’identification. Tenez compte des visages de haute qualité : frontal, clair, et la taille du visage 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 seront un tableau vide.
- Essayez « Rechercher similaire » lorsque vous avez besoin de trouver des visages similaires à partir d’une liste de visages ou d’une liste de grands visages au lieu d’un groupe de personnes ou d’un grand groupe de personnes.
- Les faceIds « recognitionModel » associés aux visages de la requête doivent être les mêmes que les « recognitionModel » utilisés par le groupe de personnes cible ou le groupe de personnes volumineux.
POST {endpoint}/face/{apiVersion}/identify
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
api
|
path | True |
string |
Version d'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 de visages de requête, créés par le « Détecter ». Chacun des visages est identifié indépendamment. Le nombre valide de faceIds est compris entre [1, 10]. |
largePersonGroupId | True |
string |
largePersonGroupId du groupe de personnes de grande taille cible, créé par « Create groupe de personnes volumineuses ». 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 modifier 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 que cette valeur de seuil fonctionne 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 |
Un appel réussi retourne la ou les personnes candidates identifiées pour chaque face de requête. |
|
Other Status Codes |
Réponse d’erreur inattendue. Headers x-ms-error-code: string |
Sécurité
Ocp-Apim-Subscription-Key
Clé secrète de votre abonnement Azure AI Face.
Type:
apiKey
In:
header
AADToken
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Nom | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Exemples
Identify from LargePersonGroup
Sample Request
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"largePersonGroupId": "your_large_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Sample Response
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Définitions
Nom | Description |
---|---|
Face |
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. |
Face |
Réponse contenant les détails de l’erreur. |
Identification |
Candidat à l’appel d’identification. |
Identification |
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 des 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 |
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 semblable. Plage comprise entre [0,1]. |
personId |
string |
personId de la personne candidate. |
IdentificationResult
Identifiez le résultat.
Nom | Type | Description |
---|---|---|
candidates |
Personne identifiée candidats pour ce visage (classé 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 de la face de la requête. |