Partager via

Person Group Operations - Create Large Person Group

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Créez un groupe de personnes volumineux avec le largePersonGroupId spécifié par l’utilisateur, un nom, un userData et recognitionModel facultatifs.
Un groupe de personnes volumineux est un conteneur contenant les données de personne chargées, y compris les fonctionnalités de reconnaissance faciale. Elle peut contenir jusqu’à 1 000 000 entités.

Après la création, utilisez « Créer une personne de groupe de personnes volumineuses » pour ajouter une personne au groupe et appelez « Former un groupe de personnes volumineuses » pour préparer ce groupe pour « Identifier à partir d’un groupe de personnes volumineuses ».

Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites de la personne et userData sont stockées sur le serveur jusqu’à ce que « Supprimer une personne de groupe de personnes volumineuses » ou « Supprimer un groupe de personnes volumineuses » soit appelée.

'recognitionModel' doit être spécifié pour associer ce groupe de personnes volumineux. La valeur par défaut de « recognitionModel » est « recognition_01 », si le dernier modèle est nécessaire, spécifiez explicitement le modèle dont vous avez besoin dans ce paramètre. Les nouveaux visages ajoutés à un groupe de personnes volumineux existant utilisent le modèle de reconnaissance déjà associé à la collection. Les fonctionnalités de visage existantes d’un groupe de personnes volumineuses ne peuvent pas être mises à jour vers les fonctionnalités extraites par une autre version du modèle de reconnaissance.

Note

    • Quota d’abonnement de niveau gratuit : 1 000 grands groupes de personnes.
    • Quota d’abonnement de niveau S0 : 1 000 000 grands groupes de personnes.
PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

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).
largePersonGroupId
 path True

string

ID du conteneur.

Modèle d’expression régulière: ^[a-z0-9-_]+$

Corps de la demande

Nom Obligatoire Type Description
name True

string

Nom défini par l’utilisateur, la longueur maximale est 128.
recognitionModel

RecognitionModel

« 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

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

Create LargePersonGroup

Exemple de requête

PUT {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Exemple de réponse

Code d’état:
200

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.

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.