Face List Operations - Add Face List Face From Url

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Ajoutez un visage à une liste de visages spécifiée, jusqu’à 1 000 visages.
Pour gérer une image contenant plusieurs visages, le visage d’entrée peut être spécifié en tant qu’image avec un rectangle targetFace. Elle retourne un persistedFaceId représentant le visage ajouté. Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites sont stockées sur le serveur jusqu’à ce que « Supprimer le visage de la liste de visages » ou « Supprimer la liste des visages » soit appelée.

Notez que persistedFaceId est différent de faceId généré par « Detect ».

• • Une meilleure qualité d’image visage signifie une meilleure précision de reconnaissance. Tenez compte des visages de haute qualité : la taille frontale, claire et faciale est de 200 x 200 pixels (100 pixels entre les yeux) ou plus.
  • Chaque entrée de personne peut contenir jusqu’à 248 visages.
  • Le format JPEG, PNG, GIF (le premier frame) et BMP sont pris en charge. La taille de fichier image autorisée est comprise entre 1 Ko et 6 Mo.
  • Le rectangle « targetFace » doit contenir un visage. Zéro ou plusieurs visages sont considérés comme une erreur. Si le rectangle « targetFace » fourni n’est pas retourné à partir de « Detect », il n’existe aucune garantie de détecter et d’ajouter le visage avec succès.
  • En dehors de la taille détectable du visage (36x36 - 4096 x 4096 pixels), une grande pose de tête ou de grandes occlusions entraîne des défaillances.
  • La taille minimale détectable du visage est de 36 x 36 pixels dans une image de plus de 1920 x 1080 pixels. Les images avec des dimensions supérieures à 1920 x 1080 pixels nécessitent une taille minimale proportionnellement plus grande.
  • Différentes valeurs « detectionModel » peuvent être fournies. Pour utiliser et comparer différents modèles de détection, reportez-vous à https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces

Avec des paramètres facultatifs:

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

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).
faceListId	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: ^[a-z0-9-_]+$
detectionModel	query		DetectionModel	« detectionModel » associé aux faceIds détectés. Les valeurs « detectionModel » prises en charge incluent « detection_01 », « detection_02 » et « detection_03 ». La valeur par défaut est « detection_01 ».
targetFace	query		integer[]	Rectangle de visage pour spécifier le visage cible à ajouter à une personne, au format « targetFace=left, top, width,height ».
userData	query		string	Données fournies par l’utilisateur attachées au visage. La limite de taille est de 1 Ko.

Corps de la demande

Nom	Obligatoire	Type	Description
url	True	string	URL de l’image d’entrée.

Réponses

Nom	Type	Description
200 OK	AddFaceResult	Un appel réussi retourne un nouvel objet persistedFaceId.
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

Add Face to FaceList from Url

Exemple de requête

HTTP

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

Exemple de réponse

Code d’état:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Définitions

Nom	Description
AddFaceResult	Corps de réponse pour l’ajout d’un visage.
DetectionModel	« detectionModel » associé aux faceIds détectés. Les valeurs « detectionModel » prises en charge incluent « detection_01 », « detection_02 » et « detection_03 ». La valeur par défaut est « detection_01 ».
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.

AddFaceResult

Corps de réponse pour l’ajout d’un visage.

Nom	Type	Description
persistedFaceId	string	ID visage persistant du visage ajouté, qui est conservé et n’expire pas. Différent de faceId créé dans « Détecter » et expirera dans 24 heures après l’appel de détection.

DetectionModel

« detectionModel » associé aux faceIds détectés. Les valeurs « detectionModel » prises en charge incluent « detection_01 », « detection_02 » et « detection_03 ». La valeur par défaut est « detection_01 ».

Nom	Type	Description
detection_01	string	Modèle de détection par défaut. Recommande de détecter les visages frontaux proches. Pour les scénarios avec des visages à angle exceptionnellement grand (pose de tête), des visages obstrués ou une orientation d’image incorrecte, les visages dans de tels cas peuvent ne pas être détectés.
detection_02	string	Modèle de détection publié en mai 2019 avec une précision améliorée en particulier sur les visages petits, côté et flou.
detection_03	string	Modèle de détection publié en février 2021 avec une précision améliorée en particulier sur les petits visages.

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.