didit-passive-liveness
by rosasalberto
Image & Video GenerationBrief
Integrate Didit Passive Liveness standalone API to verify a user is physically present.
Description
What This Skill Does
Calls the Didit Passive Liveness API to verify that a captured image shows a physically present person. Analyzes a single JPEG, PNG, WebP, or TIFF image and returns a liveness score, face quality rating, and luminance value. Detects spoofing attempts including printed photos, screen captures, masks, and deepfakes.
Single-image passive analysis needs no user interaction, cutting friction while maintaining 99.9% liveness detection accuracy.
When to Use It
- Blocking bot signups by checking selfie liveness at registration
- Gating high-risk transactions with a real-person check
- Flagging deepfake or printed-photo fraud attempts
- Confirming physical presence before KYC identity verification
- Detecting duplicate faces across sessions to prevent account sharing
Example Workflow
User asks: check whether selfie.jpg is a real person
- 1
Reads selfie.jpg from disk
- 2
POSTs the image to the Didit passive liveness endpoint with the DIDIT_API_KEY header and an 80-point decline threshold
- 3
Parses the response liveness.status field
- 4
If Declined, extracts the warnings array to identify the failure reason
- 5
Returns the status, liveness score, face quality, and any warning tags
Liveness status 'Approved' with score 95, face_quality 85.0, and no warnings, or 'Declined' with a LIVENESS_FACE_ATTACK warning if spoofing is detected
Requirements
- DIDIT_API_KEY environment variable
- Didit Business Console account at business.didit.me
Installation
clawhub install rosasalberto/didit-passive-livenessRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.