Windows

Faceplugin Face Liveness Detection Windows SDK. Fully on-premise PAD HTTP API on port 8084. POST /api/liveness. No Docker.

Fully on-premise Face Liveness HTTP API for Windows. Default port 8084. Gradio 9004. No Docker on Windows.

Score one RGB JPEG. Score ≥ 0.5 → Real / pass true. Same HTTP API as Face Liveness Detection Linux SDK. POST /api/check_liveness is an alias of /api/liveness.

Code

GitHub - Faceplugin-ltd/FaceLivenessDetection-Windows: On-premise Windows Face Liveness SDK for detecting presentation attacks (photo, screen, print, replay) from a single RGB image. Local HTTP REST API + Python bindings. No cloud, full data privacy. Ideal for KYC, access control, and identity verification.GitHub

Setup

Sizing: Hosting requirements.

1

Copy the runtime

Copy the CPU libraries from Google Drive into lib\cpu\.

2

Install and run

pip install -r requirements.txt
run.bat

3

Copy the machine code

curl -s http://127.0.0.1:8084/api/machinecode

Send machine code to Faceplugin.

4

Activate, then check liveness

curl -s -X POST http://127.0.0.1:8084/api/activate \
  -H 'Content-Type: text/plain' \
  --data-binary @license.txt

IMG=$(base64 -w0 face.jpg)
curl -s -X POST http://127.0.0.1:8084/api/liveness \
  -H 'Content-Type: application/json' \
  -d "{\"image\":\"$IMG\"}"

APIs

Endpoint	Purpose
GET /api/health	Process is listening (no license)
GET /api/machinecode	Machine code
GET /api/licenseStatus	License status
GET /api/backend	"cpu"
POST /api/activate	Activate and init_sdk()
POST /api/liveness	Passive face anti-spoofing
POST /api/check_liveness	Alias of /api/liveness

Full reference: Face Liveness HTTP API. Shared control routes: Shared endpoints.

Some routes wrap the result in a small JSON object (an envelope). POST /api/liveness returns engine JSON as the body. Score ≥ 0.5 → Real / pass true.

Python:

import sdk

sdk.get_machine_code()
sdk.activate("license.txt")
sdk.init_sdk()
print(sdk.liveness(base64_jpeg))

Try it

curl -s http://127.0.0.1:8084/api/health
IMG=$(base64 -w0 face.jpg)

curl -s -X POST http://127.0.0.1:8084/api/liveness \
  -H 'Content-Type: application/json' \
  -d "{\"image\":\"$IMG\"}"

Postman: import postman/FaceLiveness-API.postman_collection.json from the repo. Base URL http://127.0.0.1:8084.

Gradio (host only): DEMO_PORT=9004 API_BASE=http://127.0.0.1:8084 python demo.py.

Request a License & Support · Contact us

FAQ

API? Same as Linux: POST /api/liveness on port 8084. No Docker on Windows.

Active liveness? No. This product is passive JPEG anti-spoofing only.

Related documentation

• Faceplugin Face Liveness Detection Server SDK · Linux · Glossary

• Face Recognition Windows SDK

• ID Document Recognition Windows SDK

• Request a License · Status codes

• Combining products (eKYC) · SDK comparison