Person Group Operations - Create Person Group

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Créez un groupe de personnes avec personGroupId, name, userData et recognitionModel fournis par l’utilisateur.
Un groupe de personnes est un conteneur contenant les données de personne chargées, y compris les fonctionnalités de reconnaissance faciale.

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

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 la personne du groupe de personnes » ou « Supprimer le groupe de personnes » soit appelée.

'recognitionModel' doit être spécifié pour l’associer à ce groupe de personnes. 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 existant utilisent le modèle de reconnaissance déjà associé à la collection. Les fonctionnalités de visage existantes d’un groupe de personnes 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 groupes de personnes. Chacun détient jusqu’à 1 000 personnes.
  • Quota d’abonnement de niveau S0 : 1 000 000 groupes de personnes. Chacun détient jusqu’à 10 000 personnes.
  • pour gérer le problème d’identification des visages à grande échelle, envisagez d’utiliser un groupe de personnes volumineux.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

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).
personGroupId	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 PersonGroup

Exemple de requête

HTTP

PUT {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id

{
  "name": "your_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.