Categories

← View All Tools

AI Face Landmarks

Detect facial landmarks (68 points) and return coordinates for each face

Click to upload file or drag and drop file here

Maximum file size: 30MB Supported formats: image/*

Key Facts

Category
AI Tools
Input Types
file, number
Output Type
json
Sample Coverage
4
API Ready
Yes

Overview

The AI Face Landmarks tool detects 68 facial keypoints in uploaded images and returns their precise coordinates in JSON format. It enables detailed facial feature analysis for various computer vision applications.

When to Use

  • •When you need to extract detailed facial geometry from images for analysis or processing tasks.
  • •For developing or testing facial recognition systems that rely on accurate landmark detection.
  • •In projects involving augmented reality, emotion analysis, or avatar creation where facial keypoints are essential.

How It Works

  • •Upload an image file in a supported format such as JPEG or PNG.
  • •Optionally adjust the minimum confidence threshold and set the maximum number of faces to detect.
  • •The AI model processes the image to identify and locate 68 facial landmarks per face.
  • •Receive a structured JSON response containing the x and y coordinates for each detected keypoint.

Use Cases

Building facial recognition systems for security or user authentication applications.
Creating interactive augmented reality filters that respond to facial movements in real-time.
Conducting research on facial expressions by analyzing landmark positions in images or video frames.

Examples

1. Selfie App Facial Alignment

Mobile App Developer
Background
A developer is creating a selfie app that applies virtual accessories based on facial features.
Problem
Need accurate facial landmark coordinates to align accessories like glasses or hats with the user's face.
How to Use
Upload a test selfie image and set minConfidence to 0.8 for reliable detection in varied lighting.
Example Config
{"minConfidence": 0.8, "maxResults": 1}
Outcome
Received JSON with 68 landmark coordinates, enabling precise placement of virtual accessories on the detected face.

2. Emotion Analysis in Customer Feedback

Background
A market research team analyzes facial expressions from video interviews to gauge customer satisfaction.
Problem
Extracting facial landmarks from video frames to compute metrics like smile intensity or brow position.
How to Use
Extract key frames from the video, upload each image with default settings for comprehensive detection.
Outcome
Obtained coordinate data for facial points, which was used to quantify emotional responses and improve product insights.

Try with Samples

image, file
Hugging Face JavaScript Samples
Hugging Face JavaScript/TypeScript examples using Transformers.js for NLP, computer vision, and multimodal tasks in browser and Node.js
title token face
image
Hugging Face Deploy Samples
Hugging Face model deployment examples including Transformers, Diffusers, and Gradio applications with Docker and cloud deployment
title token face
image
Windows Image Processing - C# Samples
Comprehensive C# image processing examples for Windows platform including image manipulation, filtering, format conversion, and advanced computer vision operations
preferred input family image
image
OpenCV Computer Vision Samples
OpenCV.js examples for image processing, computer vision, and real-time video analysis in JavaScript
preferred input family image
image

Related Hubs

Image Tools
Explore 40 image tools for utility workflows and compare closely related utilities quickly.
Image Convert Tools
Explore 100 image tools for convert workflows and compare closely related utilities quickly.

FAQ

What image formats are supported?

The tool accepts common image formats under the image/* type, including JPEG, PNG, and GIF.

How does the minConfidence setting affect results?

A higher minConfidence value (e.g., 0.7) reduces false positives but may miss some faces, while lower values detect more faces with potentially less accuracy.

Can it detect multiple faces in a single image?

Yes, use the maxFaces option to limit detection to a specific number, or leave it empty to detect all faces up to the tool's capacity.

What is the maximum file size allowed?

Image files must be under 30 MB, as specified by the file limit of 31457280 bytes.

What does the output JSON structure look like?

The output is a JSON object with arrays of coordinates for each face, detailing 68 keypoints with x and y values for precise location data.

API Documentation

Request Endpoint

POST /en/api/tools/ai-face-landmarks

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes -
minConfidence number No -
maxResults number No -

File type parameters need to be uploaded first via POST /upload/ai-face-landmarks to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
JSON Data: JSON Data

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-ai-face-landmarks": {
      "name": "ai-face-landmarks",
      "description": "Detect facial landmarks (68 points) and return coordinates for each face",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=ai-face-landmarks",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]