Our Facial Landmarks Detection API provides an advanced solution for detecting and analyzing facial landmarks with high precision. This API supports the detection of 72, 150, and 201 key points, covering essential facial features such as eyes, eyebrows, lips, and nose contours. Additionally, it offers precise localization of facial features, including eyebrows, eyes, nose, mouth, and cheeks, as well as accurate identification of facial contours for both single and multiple faces. The API also includes face angle estimation, allowing for the determination of various facial poses in the image. Ideal for developers in the fields of photography, augmented reality, and biometric security, this API enables enhanced facial recognition and image processing capabilities. Integrate our Facial Landmarks Detection API into your application to provide users with robust and precise facial analysis tools, improving the accuracy and functionality of your facial recognition and image editing solutions.
{"error_code":0,"error_detail":{"status_code":200,"code":"","code_message":"","message":""},"log_id":"3029321544","request_id":"3029321544","result":{"face_num":1,"face_list":[{"face_token":"cc9e38750f16ed1669e80080bbe675cd","location":{"left":227.4,"top":297.37,"width":428,"height":390,"rotation":9},"face_probability":1,"angle":{"yaw":-5.4,"pitch":4.11,"roll":6.5},"age":23,"gender":{"type":"female","probability":1},"landmark4":[{"x":342.55,"y":392.89},{"x":537.16,"y":425.52},{"x":444.49,"y":492},{"x":417.93,"y":598.68}],"landmark72":[{"x":211.42,"y":389.11},{"x":211.45,"y":454.33},{"x":217.19,"y":520.68},{"x":230.51,"y":587.25},{"x":272.21,"y":653.61},{"x":333.86,"y":701.47},{"x":397.65,"y":722.14},{"x":458.56,"y":714.69},{"x":521.82,"y":680.24},{"x":567.83,"y":629.46},{"x":595.26,"y":573.74},{"x":617.43,"y":516.93},{"x":634.24,"y":460.12},{"x":292.98,"y":390.39},{"x":318.13,"y":376.28},{"x":344.48,"y":374.84},{"x":368.84,"y":386.52},{"x":387.21,"y":412.33},{"x":362.76,"y":414.49},{"x":335.75,"y":413.25},{"x":310.65,"y":404.53},{"x":342.55,"y":392.89},{"x":267.67,"y":337.43},{"x":307.64,"y":313.65},{"x":348.79,"y":317.8},{"x":384.91,"y":330.65},{"x":414.2,"y":361.04},{"x":378.63,"y":350.6},{"x":343.11,"y":336.44},{"x":306.05,"y":330},{"x":496.1,"y":431.47},{"x":520.92,"y":411.42},{"x":547.64,"y":408.35},{"x":570.53,"y":418.62},{"x":587.01,"y":440.4},{"x":567.85,"y":447.97},{"x":543.23,"y":448.07},{"x":517.74,"y":440.38},{"x":537.16,"y":425.52},{"x":496.91,"y":377.12},{"x":531.03,"y":357.65},{"x":565.65,"y":356.6},{"x":601.4,"y":364.84},{"x":625.76,"y":397.18},{"x":597.98,"y":379.65},{"x":565.2,"y":375.88},{"x":531.03,"y":377.78},{"x":418.64,"y":417.49},{"x":409.97,"y":447.95},{"x":400.39,"y":478.22},{"x":383.7,"y":515.63},{"x":413.63,"y":516.49},{"x":458.04,"y":524.06},{"x":479.96,"y":530.58},{"x":476.66,"y":489.77},{"x":474.56,"y":457.83},{"x":472.9,"y":426.24},{"x":444.49,"y":492},{"x":344.52,"y":588.53},{"x":381.99,"y":565.59},{"x":426.46,"y":565.31},{"x":464,"y":578.93},{"x":483.89,"y":612.39},{"x":453.93,"y":633.54},{"x":412.94,"y":637.6},{"x":371.08,"y":619.74},{"x":383.01,"y":583.79},{"x":422.29,"y":586.94},{"x":456.09,"y":596},{"x":451.53,"y":609.57},{"x":417.9,"y":605.64},{"x":381.4,"y":598.02}],"landmark150":{"cheek_right_1":{"x":213.31,"y":376.48},"cheek_right_3":{"x":212.31,"y":445},"cheek_right_5":{"x":216.89,"y":514.34},"cheek_right_7":{"x":228.12,"y":584.53},"cheek_right_9":{"x":270.75,"y":653.04},"cheek_right_11":{"x":332.93,"y":699.57},"chin_2":{"x":398.69,"y":722.57},"cheek_left_11":{"x":462.08,"y":717.99},"cheek_left_9":{"x":525.5,"y":684.85},"cheek_left_7":{"x":569.52,"y":629.84},"cheek_left_5":{"x":595.66,"y":570.57},"cheek_left_3":{"x":617.83,"y":511.85},"cheek_left_1":{"x":633.71,"y":451.79},"eye_right_corner_right":{"x":293.33,"y":390.13},"eye_right_eyelid_upper_2":{"x":318.25,"y":377.04},"eye_right_eyelid_upper_4":{"x":344.68,"y":375.49},"eye_right_eyelid_upper_6":{"x":369.89,"y":386.77},"eye_right_corner_left":{"x":390.44,"y":410.11},"eye_right_eyelid_lower_6":{"x":365.1,"y":412.33},"eye_right_eyelid_lower_4":{"x":337.94,"y":411.41},"eye_right_eyelid_lower_2":{"x":312.77,"y":403.81},"eye_right_eyeball_center":{"x":341.34,"y":392.67},"eyebrow_right_corner_right":{"x":266.1,"y":339.17},"eyebrow_right_upper_2":{"x":303.64,"y":314.75},"eyebrow_right_upper_3":{"x":344.8,"y":317.85},"eyebrow_right_upper_4":{"x":381.22,"y":331.85},"eyebrow_right_corner_left":{"x":410.94,"y":362.62},"eyebrow_right_lower_3":{"x":374.82,"y":350.73},"eyebrow_right_lower_2":{"x":340.14,"y":335.51},"eyebrow_right_lower_1":{"x":302.89,"y":329.1},"eye_left_corner_right":{"x":492.67,"y":428.42},"eye_left_eyelid_upper_2":{"x":518.31,"y":410.95},"eye_left_eyelid_upper_4":{"x":545.71,"y":408.81},"eye_left_eyelid_upper_6":{"x":569,"y":419.01},"eye_left_corner_left":{"x":585.88,"y":440.01},"eye_left_eyelid_lower_6":{"x":565.43,"y":446.83},"eye_left_eyelid_lower_4":{"x":540.8,"y":446.05},"eye_left_eyelid_lower_2":{"x":515,"y":438.53},"eye_left_eyeball_center":{"x":536.12,"y":425.9},"eyebrow_left_corner_right":{"x":495.13,"y":377.7},"eyebrow_left_upper_2":{"x":529.83,"y":358.02},"eyebrow_left_upper_3":{"x":565,"y":356.28},"eyebrow_left_upper_4":{"x":599.49,"y":366.73},"eyebrow_left_corner_left":{"x":619.9,"y":400.87},"eyebrow_left_lower_3":{"x":595.48,"y":380.91},"eyebrow_left_lower_2":{"x":563.7,"y":375.62},"eyebrow_left_lower_1":{"x":529.85,"y":378.42},"nose_right_contour_1":{"x":418.86,"y":416.29},"nose_right_contour_2":{"x":410.51,"y":446.37},"nose_right_contour_3":{"x":402.36,"y":476.4},"nose_right_contour_4":{"x":383.4,"y":513.02},"nose_right_contour_6":{"x":410.52,"y":516.68},"nose_left_contour_6":{"x":456.86,"y":525.44},"nose_left_contour_4":{"x":478.09,"y":528.98},"nose_left_contour_3":{"x":474.87,"y":488.63},"nose_left_contour_2":{"x":473.23,"y":457.12},"nose_left_contour_1":{"x":471.49,"y":425.63},"nose_tip":{"x":442.2,"y":496.31},"mouth_corner_right_outer":{"x":341.24,"y":585.81},"mouth_lip_upper_outer_3":{"x":379.69,"y":563.4},"mouth_lip_upper_outer_6":{"x":426.17,"y":562.78},"mouth_lip_upper_outer_9":{"x":466.59,"y":577.21},"mouth_corner_left_outer":{"x":486.51,"y":610.45},"mouth_lip_lower_outer_9":{"x":456.17,"y":631.45},"mouth_lip_lower_outer_6":{"x":413.57,"y":633.21},"mouth_lip_lower_outer_3":{"x":370.08,"y":617.74},"mouth_lip_upper_inner_3":{"x":380.98,"y":580.09},"mouth_lip_upper_inner_6":{"x":422.31,"y":583.11},"mouth_lip_upper_inner_9":{"x":458.37,"y":593.28},"mouth_lip_lower_inner_9":{"x":453.4,"y":609.05},"mouth_lip_lower_inner_6":{"x":418.46,"y":604.37},"mouth_lip_lower_inner_3":{"x":380.29,"y":597.38},"cheek_right_2":{"x":212.93,"y":410.5},"cheek_right_4":{"x":214.39,"y":479.51},"cheek_right_6":{"x":220.68,"y":550.2},"cheek_right_8":{"x":245.39,"y":621.53},"cheek_right_10":{"x":300.01,"y":678.73},"chin_1":{"x":364.7,"y":714.6},"chin_3":{"x":430.51,"y":724.12},"cheek_left_10":{"x":495.61,"y":704.82},"cheek_left_8":{"x":549.96,"y":659.87},"cheek_left_6":{"x":583.27,"y":600.8},"cheek_left_4":{"x":607.33,"y":541.8},"cheek_left_2":{"x":626.35,"y":482.51},"eyebrow_right_upper_1":{"x":267.94,"y":331.45},"eyebrow_right_upper_5":{"x":413.45,"y":350.56},"eyebrow_left_upper_1":{"x":496.52,"y":365.34},"eyebrow_left_upper_5":{"x":621.09,"y":392.67},"eye_right_eyelid_upper_1":{"x":304.44,"y":381.64},"eye_right_eyelid_upper_3":{"x":331.09,"y":373.67},"eye_right_eyelid_upper_5":{"x":358.57,"y":378.95},"eye_right_eyelid_upper_7":{"x":381.67,"y":397.09},"eye_right_eyelid_lower_7":{"x":377.69,"y":411.71},"eye_right_eyelid_lower_5":{"x":351.62,"y":413.56},"eye_right_eyelid_lower_3":{"x":324.75,"y":409.51},"eye_right_eyelid_lower_1":{"x":302.54,"y":398.2},"eye_right_eyeball_right":{"x":320.4,"y":391},"eye_right_eyeball_left":{"x":361.31,"y":397.8},"eye_left_eyelid_upper_1":{"x":503.74,"y":417.52},"eye_left_eyelid_upper_3":{"x":531.35,"y":407.53},"eye_left_eyelid_upper_5":{"x":558.43,"y":411.84},"eye_left_eyelid_upper_7":{"x":579.32,"y":428.12},"eye_left_eyelid_lower_7":{"x":575.56,"y":444.47},"eye_left_eyelid_lower_5":{"x":553.17,"y":448.07},"eye_left_eyelid_lower_3":{"x":527.36,"y":443.86},"eye_left_eyelid_lower_1":{"x":503.32,"y":434.23},"eye_left_eyeball_right":{"x":515.84,"y":424.58},"eye_left_eyeball_left":{"x":556.66,"y":430.73},"nose_bridge_1":{"x":447.91,"y":420.66},"nose_bridge_2":{"x":445.64,"y":451.94},"nose_bridge_3":{"x":443.32,"y":483.13},"nose_right_contour_5":{"x":397.12,"y":529.26},"nose_right_contour_7":{"x":411.09,"y":503.25},"nose_left_contour_7":{"x":461.95,"y":512.58},"nose_left_contour_5":{"x":462.48,"y":540.26},"nose_middle_contour":{"x":431.88,"y":537.16},"mouth_corner_right_inner":{"x":347,"y":585.72},"mouth_corner_left_inner":{"x":481.52,"y":608.27},"mouth_lip_upper_outer_1":{"x":351.78,"y":575.3},"mouth_lip_upper_outer_2":{"x":364.76,"y":567.86},"mouth_lip_upper_outer_4":{"x":394.51,"y":557.96},"mouth_lip_upper_outer_5":{"x":410.21,"y":557.41},"mouth_lip_upper_outer_7":{"x":441.58,"y":563.41},"mouth_lip_upper_outer_8":{"x":455.29,"y":568.3},"mouth_lip_upper_outer_10":{"x":476.87,"y":586.34},"mouth_lip_upper_outer_11":{"x":483.55,"y":597.48},"mouth_lip_lower_outer_11":{"x":477.84,"y":619.73},"mouth_lip_lower_outer_10":{"x":468.21,"y":627.16},"mouth_lip_lower_outer_8":{"x":442.45,"y":635.54},"mouth_lip_lower_outer_7":{"x":428.47,"y":636.02},"mouth_lip_lower_outer_5":{"x":397.32,"y":631.81},"mouth_lip_lower_outer_4":{"x":382.9,"y":626.59},"mouth_lip_lower_outer_2":{"x":357.81,"y":609.33},"mouth_lip_lower_outer_1":{"x":348.66,"y":598.32},"mouth_lip_upper_inner_1":{"x":354.69,"y":582.61},"mouth_lip_upper_inner_2":{"x":367.18,"y":580.48},"mouth_lip_upper_inner_4":{"x":394.89,"y":578.02},"mouth_lip_upper_inner_5":{"x":408.31,"y":578.95},"mouth_lip_upper_inner_7":{"x":435.23,"y":583.8},"mouth_lip_upper_inner_8":{"x":446.95,"y":587.1},"mouth_lip_upper_inner_10":{"x":468.75,"y":597.9},"mouth_lip_upper_inner_11":{"x":477.16,"y":603.44},"mouth_lip_lower_inner_11":{"x":474.97,"y":610.84},"mouth_lip_lower_inner_10":{"x":465,"y":610.23},"mouth_lip_lower_inner_8":{"x":441.62,"y":607.74},"mouth_lip_lower_inner_7":{"x":430.57,"y":606.11},"mouth_lip_lower_inner_5":{"x":405.1,"y":602.18},"mouth_lip_lower_inner_4":{"x":393.08,"y":600},"mouth_lip_lower_inner_2":{"x":366.38,"y":594.11},"mouth_lip_lower_inner_1":{"x":354.07,"y":590.78}},"landmark201":{"cheek_right_1":{"x":213.22915649414,"y":372.33111572266},"cheek_right_3":{"x":211.96017456055,"y":439.81048583984},"cheek_right_5":{"x":215.05560302734,"y":508.29144287109},"cheek_right_7":{"x":224.61000061035,"y":578.12634277344},"cheek_right_9":{"x":266.06130981445,"y":649.23956298828},"cheek_right_11":{"x":330.36294555664,"y":698.38012695312},"chin_2":{"x":395.84976196289,"y":721.20947265625},"cheek_left_11":{"x":460.86743164062,"y":715.66754150391},"cheek_left_9":{"x":528.61138916016,"y":682.13861083984},"cheek_left_7":{"x":577.67846679688,"y":626.98022460938},"cheek_left_5":{"x":603.46160888672,"y":566.48693847656},"cheek_left_3":{"x":624.44720458984}}}]},"_note":"Response truncated for documentation purposes"}
curl --location 'https://zylalabs.com/api/4439/facial+landmarks+api/5452/facial+landmarks' \
--header 'Content-Type: application/json' \
--form 'image=@"FILE_PATH"'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime.
Our Facial Landmarks Detection API provides an advanced solution for detecting and analyzing facial landmarks with high precision. This API supports the detection of 72, 150, and 201 key points, covering essential facial features such as eyes, eyebrows, lips, and nose contours. Additionally, it offers precise localization of facial features, including eyebrows, eyes, nose, mouth, and cheeks, as well as accurate identification of facial contours for both single and multiple faces. The API also includes face angle estimation, allowing for the determination of various facial poses in the image.
Facial Recognition: Enhancing the accuracy of facial recognition systems by identifying key facial features. Animation and Gaming: Creating realistic facial animations by mapping facial landmarks for character models. Augmented Reality (AR): Enabling AR applications to accurately place virtual elements on users’ faces, such as filters and masks. Beauty and Cosmetics: Powering virtual makeup and beauty apps to apply cosmetics accurately on facial features. Photography and Videography: Improving facial detection for better focusing and exposure settings in cameras.
High Precision: Provides accurate identification of key facial features, enhancing the effectiveness of applications relying on facial analysis. Real-Time Processing: Capable of identifying facial landmarks in real time, making it suitable for live applications such as AR and security monitoring. Versatility: Applicable to various fields, including facial recognition, animation, AR, medical diagnostics, beauty, photography, security, and human-computer interaction. Consistency: Delivers reliable and consistent results across different faces and conditions.
Computer Vision Researchers and Engineers: Professionals and academics who work on developing facial recognition systems, emotion detection algorithms, and other applications requiring precise facial landmark localization. Augmented Reality (AR) and Virtual Reality (VR) Developers: Individuals creating immersive experiences that involve facial tracking and interaction. Healthcare Practitioners and Researchers: Those studying facial anatomy for medical diagnosis, facial reconstruction, or facial expression analysis in psychological research. Digital Artists and Animators: Creators who use facial landmarks for character animation, facial morphing, and other visual effects.
The Facial Landmarks API returns data related to facial features, including the number of detected faces, their locations, face tokens, confidence levels, and detailed landmark coordinates. It also provides additional information such as age, gender, and facial angles.
Key fields in the response include `face_num` (number of faces detected), `face_list` (details of each face), `face_probability` (confidence score), and various landmark arrays (e.g., `landmark4`, `landmark72`, etc.) that provide coordinates for facial features.
The response data is structured as a JSON object containing public parameters (like `request_id` and `error_code`) and business parameters (like `result`, which includes face details). Each face's information is nested within the `face_list` array.
The endpoint accepts parameters such as `image` (required), `max_face_num` (optional, to specify the number of faces to detect), and `face_field` (optional, to request additional information like age and gender).
Users can customize requests by adjusting the `max_face_num` to detect multiple faces and selecting specific `face_field` values to retrieve additional data, such as `landmark150` or `gender`, based on their application needs.
The API provides information on facial landmarks, face locations, confidence scores, age, gender, and facial angles. Users can choose to receive varying levels of detail by specifying the `face_field` parameter.
Users can utilize the returned data by analyzing the `face_list` for facial feature coordinates, using `face_probability` for confidence assessments, and leveraging age and gender data for demographic insights in applications like marketing or security.
Typical use cases include enhancing facial recognition systems, developing AR applications with real-time facial tracking, creating personalized beauty filters, and conducting demographic analysis in user engagement studies.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
210ms
Service Level:
100%
Response Time:
237ms
Service Level:
100%
Response Time:
152ms
Service Level:
100%
Response Time:
152ms
Service Level:
100%
Response Time:
122ms
Service Level:
100%
Response Time:
812ms
Service Level:
100%
Response Time:
364ms
Service Level:
100%
Response Time:
283ms
Service Level:
100%
Response Time:
261ms
Service Level:
100%
Response Time:
264ms
