Face Liveness Detection API

Verify real humans,
not photos.

Challenge-response biometric verification. 8 challenge types, 5 per session, impossible to spoof with a photo or screen replay.

8 challenge types5 per session<500ms response99.9% uptime SLA

How it works

01

Create a session

Your backend calls POST /v1/sessions with your API key. Gets back a session ID and 5 random challenges.

02

User completes challenges

Your frontend uses the SDK. It opens the camera, shows each challenge, and submits frames every 800ms.

03

Get the result

Every frame is analyzed server-side with MediaPipe. When all 5 challenges pass, you get a liveness score.

8 biometric challenge types

5 are chosen randomly per session so attackers can't predict the sequence.

👁
Blink
Eye aspect ratio detection
😊
Smile
Mouth width ratio analysis
Turn Left
Horizontal nose offset
Turn Right
Horizontal nose offset
👄
Open Mouth
Mouth height to face ratio
Look Down
Vertical nose position
⬆⬆
Raise Eyebrows
Eyebrow-to-eye gap

Quick start

// 1. Create session on your backend
const { session_id } = await fetch('/v1/sessions', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.LIVENESS_KEY },
  body: JSON.stringify({ challenge_count: 5 }),
}).then(r => r.json())

// 2. Run checks in the browser with the SDK
import { LivenessClient } from '@liveness/sdk'
const result = await new LivenessClient({ apiUrl: '...' })
  .run(session_id, videoElement, apiKey)

// result: { passed: true, score: 0.97, sessionId: '...' }

Simple pricing

Start free. Scale as you grow.

Free
$0forever

100 checks / day

  • 5 random challenges per session
  • Spoof detection
  • REST API + SDK
  • Community support
Get started free
ProPopular
$29/ month

1,000 checks / day

  • Everything in Free
  • Priority support
  • Webhook events
  • Usage analytics
Start Pro trial
Enterprise
$199/ month

10,000 checks / day

  • Everything in Pro
  • Custom challenge sets
  • SLA guarantee
  • Dedicated support
Contact sales

Ready to ship liveness detection?

Free plan includes 100 checks per day. No credit card required.

Create free account