Face Liveness

Face Liveness Overview

The Liveness Verification API checks whether a person in the camera or frames is a real live human and not a photo, video, or fake image. It analyzes the face and small movements (like blinking, head turns, texture, light changes) to confirm the person is actually present.

The system uses FastAPI and modern face detection and anti-spoofing models. It works with base64 images or frames and can handle different lighting, camera quality, and face angles.

This document explains how the system works, the tools used, the API endpoints, and how developers can integrate liveness checking into their apps or KYC process.

Follow these steps

Follow the Authentication steps - click here

Liveness Verification API

Checks whether the submitted face frames or selfie belong to a real live person and not a photo or spoof.

End point:

Request

Method:POST
Content-Type:application/json

Authorization :

Format: Authorization: Bearer <token>

Parameters:

frames (file): At least 3 frame lists. (e.g [“abc”,”abc”, “abc” ]).M
unique_id : reference id for your system reference. (e.g., USER0001) - OP

HINT:

M = Mandatory
OP = Optional

Response

Status Code: 200 OK
Data
1. reference_id - For your reference

Example Request

curl --location 'https://strctluat.gosense.ai/api/v1/sense/liveness/analysis'
    --header 'Content-Type: application/json' 
    --header 'Authorization: Bearer ……….
    --data '{
        "unique_id" : "USER123",
        "frames": [
        "1", "2", "3"
        ]
    }

{
  	 	"success": true,
  		"message": "Liveness info recorded successfully”,
  		"code": 8044,
  		"data": {
            "reference_id": "a563c597-2249-40cb-b775-dd453da0acc9",
            "status": "completed",
            "response": {
                    "label": "Spoof",
                    "confidence": 0.88
            }
        }
    }