API Documentation

Mise en route

Pour commencer, vous devez souscrire un des Packs API pour obtenir une clé personnelle API. Chaque pack a un quota d'utilisation, donc chaque requête vers notre serveur d'analyse s'ajoutera à votre quota d'utilisation. Pour plus d'informations sur l'utilisation du quota, veuillez vous référer à la tarification.

Notre serveur d'analyse traite n'importe quelle photos de visage humain.

Remarques sur l'utilisation

1. Notez que la hauteur de la photo téléchargée ou la largeur maximale est de 800 pixels. Vous pouvez envoyer des liens (URL) de photos.

Base URL d'entrée API : http://facesession.com/FDIAG_WEB/FR/zAPIface01.awp?APIKEY={votre_clé_api}&URL={adresse_web_de_votre_photo}

2. Lorsque vous soumettez une photo de petite taille, veillez à ce que le visage soit bien visible (comme une photo d'identité), les oreilles, les cheveux et le cou afin que notre serveur analyse le visage avec précision. En outre, lunettes de soleil, chapeau ou quoi que ce soit qui brouille les visages peut corrompre les performances de l'api.

Détection du visage et exemple

Une des fonctions de détection principale de l'API, est la détection des informations géométriques des yeux, nez et bouche, ainsi que divers attributs tels que l'émotion, la race, le sexe, le sourire, si vous le portez des lunettes, si la bouche est ouverte, etc.

:: Exemple : (Veuillez remplacer la clé api_key en rouge par votre clé personnelle que vous avez acheté, et l'adresse URL en bleu par l'adresse web de votre photo)

http://facesession.com/FDIAG_WEB/FR/zAPIface01.awp?APIKEY=74be16979710d4c4e7c66&URL=http://facediag.com/people.jpg
:: Exemple de réponse du serveur au format standard JSON :
{"url":"http:\/\/facediag.com\/people.jpg","face_detection":[{"boundingbox":{"tl":{"x":43.08,"y":113.85},"size":{"width":245.38,"height":245.38}},"confidence":1,"eye_left":{"x":112.9,"y":210.5},"eye_right":{"x":217.3,"y":205.1},"nose":{"x":170.1,"y":268},"mouth l":{"x":119.2,"y":308.4},"mouth_l":{"x":119.2,"y":308.4},"mouth r":{"x":214.8,"y":303.7},"mouth_r":{"x":214.8,"y":303.7},"pose":{"roll":-4.13,"yaw":6.17,"pitch":-6.94},"b_ll":{"x":76.1,"y":183.8},"b_lm":{"x":106.8,"y":175.3},"b_lr":{"x":137.6,"y":185},"b_rl":{"x":194.9,"y":180.8},"b_rm":{"x":222.3,"y":170.1},"b_rr":{"x":250.9,"y":171.6},"e_ll":{"x":91.3,"y":210.8},"e_lr":{"x":134.5,"y":214.3},"e_lu":{"x":113.4,"y":201.7},"e_ld":{"x":112.4,"y":217.3},"e_rl":{"x":195,"y":211.3},"e_rr":{"x":239.1,"y":203.5},"e_ru":{"x":216.4,"y":196.2},"e_rd":{"x":218.4,"y":211.8},"n_l":{"x":145.1,"y":279.9},"n_r":{"x":191,"y":277.6},"m_u":{"x":168.7,"y":300},"m_d":{"x":168.5,"y":337.2},"race":{"white":0.93},"emotion":{"happy":0.99,"surprised":0.07,"calm":0},"age":27.25,"smile":0.99,"glasses":0,"eye_closed":0,"mouth_open_wide":0.07,"sex":0}],"ori_img_size":{"width":330,"height":400},"usage":{"quota":39769,"status":"Succeed.",xxx}}

Légende des codes de retour : (les valeurs sont exprimées en %. Exemple : 0.30 = 30%)

1. boundingbox : la taille et la position du visage
2. confidence : % de pertinence (ex. s'il s'agit d'un visage)
3. eye_left, eye_right, nose, mouth_l, mouth_r : position des yeux, nez et bouche
4. pose : la position du visage en 3D,
5. b_lm, b_lr, b_rl, b_rm, b_rr, e_ll, e_lr, e_lu, e_ld, e_rl, e_rr, e_ru, e_rd, n_l, n_r, m_u, m_d : position des points supplémentaires autours du visage.
6. keypoints_v1 : position des points autours du visage
7. pupil_l, pupil_r : position des pupilles
8. race : valeurs possibles : 1) white, 2) asian, 3) black, 4) indian
9. emotion : valeurs possibles : 1) happy, 2) said, 3) confused, 4) disgusting, 5) surprised 6) angry 7) calm
10. age : âge du visage
11. smile : Si le visage est souriant, le serveur renvoie une valeur de 0 ou 1. Le chiffre 0 signifie aucun sourire, 1 signifie sourire complet.
12. eye_closed : 0 = yeux ouverts, 1 = yeux fermés.
13. mouth_open_wide : 0 = bouche fermée, 1 = bouche ouverte.
14. sex : genre Homme (1) ou Femme (0)

 

Affichage des points sur la photo

Une des fonctions visuelle de l'API, est l'affichage des points sur la photo, sans que vous ayez besoin de programmer quoi que se soit. De la même façon, il vous suffit simplement de soumettre une requête API depuis votre navigateur (ou application) pour obtenir immédiatement le visuel de détection faciale.

:: Exemple : (Veuillez remplacer la clé api_key en rouge par votre clé personnelle que vous avez acheté, et l'adresse URL en bleu par l'adresse web de votre photo)

http://facesession.com/FDIAG_WEB/FR/zAPIface01view.awp?APIKEY=74be16979710d4c4e7c66&URL=http://facediag.com/people.jpg
Weeface API