About

FaceLooking provides a powerful REST API for face detection and recognition. It offers fast and accurate face recognition capabilities for your applications.

Features

⚡ Fast

300-900ms detection with face embeddings

🎯 Accurate

Uses deep learning model

🔌 REST API

Clean HTTP endpoints for easy integration

🔐 Secure

API key authentication

🔄 Hot Reload

Update known faces on-the-fly

API Endpoints

All endpoints are available at https://api.facelooking.com/v1/

GET /v1/health Public

Health check endpoint

GET /v1/status

Service status and loaded faces count

POST /v1/recognize

Recognize faces in uploaded image

POST /v1/faces/upload

Upload face image to user directory

GET /v1/faces/<directory>

List faces in a directory

DELETE /v1/faces/<directory>/<name>

Delete a face image

Quick Start

Health Check

curl https://api.facelooking.com/v1/health

Recognize Faces

curl -X POST https://api.facelooking.com/v1/recognize \
-H "X-API-Key: YOUR_API_KEY" \
-F "image=@photo.jpg"

Authentication

Use API keys for authentication:

  • Authorization Header: Authorization: Bearer YOUR_API_KEY
  • X-API-Key Header: X-API-Key: YOUR_API_KEY
  • Query Parameter: ?api_key=YOUR_API_KEY