MediaPipe

Face Mesh & Pose Estimation

MediaPipe provides real-time face mesh and pose estimation. Extract 468 facial landmarks, 33 body keypoints, and 21 hand landmarks from images and videos.

Endpoint

POST https://api-gpuse.maatrics.com/v1/mediapipe/face-mesh

Available Features

face_mesh

468 facial landmarks for detailed face analysis

pose

33 body keypoints for pose estimation

hands

21 landmarks per hand for gesture recognition

Parameters

Name	Type	Required	Description
url	string	Yes	URL of the image or video file
features	array	No	Features to extract: face_mesh, pose, hands
webhook	string	No	URL for completion notification

Request Example

bash

curl -X POST "https://api-gpuse.maatrics.com/v1/mediapipe/face-mesh" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/video.mp4",
    "features": ["face_mesh", "pose"],
    "webhook": "https://your-server.com/webhook"
  }'

Response

json

{
  "job_id": "mp-face-123-456",
  "status": "processing",
  "created_at": "2024-01-15T10:30:00Z"
}

Completed Result

json

{
  "job_id": "mp-face-123-456",
  "status": "completed",
  "result": {
    "frames": [
      {
        "frame_number": 0,
        "timestamp": 0.0,
        "faces": [
          {
            "landmarks": [
              {"x": 0.5, "y": 0.3, "z": 0.1},
              {"x": 0.52, "y": 0.32, "z": 0.12}
            ],
            "bounding_box": {
              "x": 100, "y": 50, "width": 200, "height": 250
            }
          }
        ],
        "pose": {
          "landmarks": [
            {"name": "nose", "x": 0.5, "y": 0.2, "z": 0.0, "visibility": 0.99},
            {"name": "left_shoulder", "x": 0.3, "y": 0.5, "z": 0.1, "visibility": 0.95}
          ]
        }
      }
    ],
    "total_frames": 1800,
    "fps": 30
  },
  "cost": 0.06,
  "processing_time": 12.5
}

Pricing

$0.001per image

Video: $0.03 per minute. CPU-optimized for low cost.

← YOLO v11 View All Pricing →