Face List Operations - Create Large Face List
Create une grande liste de visages vide avec largeFaceListId, name, un userData et recognitionModel facultatifs.
Grande liste de visages est une liste de visages, jusqu’à 1 000 000 visages, et utilisée par « Rechercher similaire à partir de grandes listes de visages ».
Après la création, l’utilisateur doit utiliser Ajouter un visage de liste de visages volumineux pour importer les visages et entraîner la liste de grands visages pour la préparer pour « Rechercher similaire ». Aucune image n’est stockée. Seules les fonctionnalités de visage extraites seront stockées sur le serveur jusqu’à ce que la suppression de la liste de grands visages soit appelée.
« Rechercher similaire » est utilisé pour des scénarios tels que la recherche de visages ressemblant à des célébrités, le filtrage de visage similaire ou comme une identification de visage de manière légère. Toutefois, si l’utilisation réelle est d’identifier une personne, utilisez groupe de personnes/grand groupe de personnes et « Identifier ».
Notes
-
- Quota d’abonnement de niveau gratuit : 64 grandes Listes.
- Quota d’abonnement de niveau S0 : 1 000 000 Listes grand visage.
PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}
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). |
large
|
path | True |
string |
Le caractère valide est une lettre en minuscules ou un chiffre ou « - » ou « _ », la longueur maximale est de 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 facultatives définies par l’utilisateur. La longueur ne doit pas dépasser 16 000. |
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 LargeFaceList
Exemple de requête
PUT {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id
{
"name": "your_large_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 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. |