Face List Operations - Create Face List
Créez une liste de visages vide avec faceListId spécifié par l’utilisateur, un nom, un userData facultatif et recognitionModel.
Jusqu’à 64 listes de visages sont autorisées dans un abonnement.
La liste des visages est une liste de visages, jusqu’à 1 000 visages et utilisée par « Rechercher des visages similaires à partir de la liste des visages ».
Après la création, l’utilisateur doit utiliser « Ajouter un visage de liste de visages » pour importer les visages. Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites sont stockées sur le serveur jusqu’à ce que « Supprimer la liste des visages » soit appelée.
« Rechercher similaire » est utilisé pour des scénarios tels que la recherche de visages similaires, le filtrage des visages similaires ou comme une identification légère des visages. Toutefois, si l’utilisation réelle consiste à identifier la personne, utilisez le groupe de personnes / groupe de personnes volumineux et « Identifier ».
Tenez compte de la liste des visages volumineux lorsque le nombre de visages est grand. Il peut prendre en charge jusqu’à 1 000 000 visages.
PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
api
|
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). |
face
|
path | True |
string |
Le caractère valide est la lettre en minuscules ou en chiffres ou '-' ou '_', la longueur maximale est 64. Modèle d’expression régulière: |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
name | True |
string |
Nom défini par l’utilisateur, la longueur maximale est 128. |
recognitionModel |
Recognition |
« recognitionModel » associé à cette liste de visages. Les valeurs « recognitionModel » prises en charge incluent « recognition_01 », « recognition_02, « recognition_03 » et « recognition_04 ». La valeur par défaut est « recognition_01 ». 'recognition_04' est recommandé, car sa précision est améliorée sur les visages portant des masques par rapport à 'recognition_03', et sa précision globale est améliorée par rapport à 'recognition_01' et 'recognition_02'. |
|
userData |
string |
Données définies par l’utilisateur facultatives. La longueur ne doit pas dépasser 16 Ko. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
La demande a réussi. |
|
Other Status Codes |
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
Create FaceList
Exemple de requête
PUT {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id
{
"name": "your_face_list_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Exemple de réponse
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. |
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 |
Objet d’erreur. |