Partager via


Face List - Add Face From Stream

Ajoutez un visage à une liste de visages spécifiée, jusqu'à 1 000 visages.
Pour traiter une image contenant plusieurs visages, le visage d’entrée peut être spécifié en tant qu’image avec un rectangle targetFace. Il retourne unFaceId persistant représentant le visage ajouté. Aucune image n’est stockée. Seule la fonctionnalité de visage extraite est stockée sur le serveur jusqu’à ce que FaceList - Delete Face ou FaceList - Delete soit appelé.
Notez que persistedFaceId est différent de faceId généré par Visage - Détecter.

  • Une meilleure qualité d’image du visage signifie une meilleure précision de détection et de reconnaissance. Tenez compte des visages de haute qualité : frontal, clair, et la taille du visage est de 200 x 200 pixels (100 pixels entre les yeux) ou plus.
  • Les formats JPEG, PNG, GIF (première image) et BMP sont pris en charge. La taille du fichier image autorisée est de 1 Ko à 6 Mo.
  • Le rectangle « targetFace » doit contenir un visage. Zéro ou plusieurs visages seront considérés comme une erreur. Si le rectangle « targetFace » fourni n’est pas retourné à partir de Visage - Détecter, il n’y a aucune garantie de détecter et d’ajouter le visage avec succès.
  • Une taille de visage hors détectable (36x36 - 4096x4096 pixels), une grande pose de tête ou des occlusions volumineuses entraînent des échecs.
  • L’ajout/la suppression de visages vers/à partir d’une même liste de visages sont traités séquentiellement et vers/à partir de différentes listes de visages sont en parallèle.
  • La taille minimale détectable du visage est de 36 x 36 pixels dans une image ne dépassant pas 1920 x 1080 pixels. Les images dont les dimensions sont supérieures à 1920 x 1080 pixels auront besoin d’une taille minimale proportionnellement plus grande.
  • Différentes valeurs « detectionModel » peuvent être fournies. Pour utiliser et comparer différents modèles de détection, consultez Comment spécifier un modèle de détection.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Paramètres URI

Nom Dans Obligatoire Type Description
Endpoint
path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).

faceListId
path True

string

ID référençant une liste de visages particulière.

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

detectionModel
query

DetectionModel

Nom du modèle de détection. Le modèle de détection est utilisé pour détecter les visages dans l’image envoyée. Un nom de modèle de détection peut être fourni lors de l’exécution de Visage - Détecter ou (Large)FaceList - Ajouter un visage ou (Large)PersonGroup - Ajouter un visage. La valeur par défaut est « detection_01 ». Si un autre modèle est nécessaire, spécifiez-le explicitement.

targetFace
query

integer[]

Rectangle de visage pour spécifier le visage cible à ajouter à une personne au format « targetFace=left,top,width,height ». Par exemple, « targetFace= 10,10,100,100 ». S’il existe plusieurs visages dans l’image, targetFace est nécessaire pour spécifier le visage à ajouter. L’absence de targetFace signifie qu’il n’y a qu’un seul visage détecté dans l’ensemble de l’image.

userData
query

string

Données spécifiées par l’utilisateur sur le visage à n’importe quel usage. La longueur maximale est de 1 Ko.

En-tête de la demande

Media Types: "application/octet-stream"

Nom Obligatoire Type Description
Ocp-Apim-Subscription-Key True

string

Corps de la demande

Media Types: "application/octet-stream"

Nom Type Description
Image

object

Flux d’images.

Réponses

Nom Type Description
200 OK

PersistedFace

Un appel réussi retourne un nouveauFaceId persistant.

Other Status Codes

APIError

Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Add face to face list from stream example

Exemple de requête

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Exemple de réponse

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Définitions

Nom Description
APIError

Informations d’erreur retournées par l’API

DetectionModel

Nom du modèle de détection. Le modèle de détection est utilisé pour détecter les visages dans l’image envoyée. Un nom de modèle de détection peut être fourni lors de l’exécution de Visage - Détecter ou (Large)FaceList - Ajouter un visage ou (Large)PersonGroup - Ajouter un visage. La valeur par défaut est « detection_01 ». Si un autre modèle est nécessaire, spécifiez-le explicitement.

Error

Corps de l’erreur.

PersistedFace

Objet PersonFace.

APIError

Informations d’erreur retournées par l’API

Nom Type Description
error

Error

Corps de l’erreur.

DetectionModel

Nom du modèle de détection. Le modèle de détection est utilisé pour détecter les visages dans l’image envoyée. Un nom de modèle de détection peut être fourni lors de l’exécution de Visage - Détecter ou (Large)FaceList - Ajouter un visage ou (Large)PersonGroup - Ajouter un visage. La valeur par défaut est « detection_01 ». Si un autre modèle est nécessaire, spécifiez-le explicitement.

Nom Type Description
detection_01

string

detection_02

string

detection_03

string

Error

Corps de l’erreur.

Nom Type Description
code

string

message

string

PersistedFace

Objet PersonFace.

Nom Type Description
persistedFaceId

string

PersistedFaceId de la face cible, qui est conservé et n’expirera pas. Différent de faceId créé par Face - Détecter et expirera à l’heure spécifiée par faceIdTimeToLive après l’appel de détection.

userData

string

Données fournies par l’utilisateur attachées au visage. La limite de taille est de 1 Ko.