# Seventh Sense Face Anti-Spoofing / Liveness API

**Canonical:** https://apis.io/apis/seventh-sense/seventh-sense-face-anti-spoofing-liveness-api/  
**Provider:** Seventh Sense — https://apis.io/providers/seventh-sense/  
**Base URL:** https://us.opencv.fr  
**Documentation:** https://us.opencv.fr/docs

Seventh Sense Face Anti-Spoofing / Liveness API is one of 5 APIs that [Seventh Sense](https://apis.io/providers/seventh-sense/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Face Anti-Spoofing / Liveness. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The `/liveness` endpoint allows you to determine if a face image is of a real person or a spoofed image (eg. a printed image of a face, or an image captured from a tablet's screen). The endpoint returns a score between 0 and 1, where 1 is a real person and 0 is a spoofed image, the threshold for the image to be considered live is >= 0.5.<br/><br/> Our liveness achieved Attack Presentation Classification Error Rate (APCER) of 0% and reached iBeta Level 2 compliance in accordance with ISO 30107-3. <br/><br/>**Note:** The `/liveness` endpoint does not store any information on our servers. It is a one-time classification of an image using a deep learning model. If you want to store the images and search for them later, use the `/person` endpoint to register persons for a later search using the `/search` endpoint.<br/><br/>To ensure fraudsters cannot use high-resolution print outs, masks or video playbacks to spoof face recognition systems, liveness image has a higher requirement on image:<br/><br/>Liveness image requirement:<br/> <ul> <li>There should only be one main face on the image. It should be fully visible within a frame and fully open without any occlusions. No crop is allowed. Small faces in the background are not taken into account.</li> <li>The minimum size of a face box that can be processed is 224x224 pixels.</li> <li>The padding between the face box and the image's borders should be at least 25 pixels.</li> <li>The distance between the pupils on the face should be at least 80 pixels.</li> <li>The out-of-plane rotation angle (face pitch and yaw) should be no more than ±30 degrees.</li> <li>Fish-eye lenses and sunglass images are not supported.</li> </ul>

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/seventh-sense/refs/heads/main/openapi/seventh-sense-face-anti-spoofing-liveness-api-openapi.yml
- **Documentation** — https://docs.opencv.fr
- **APIReference** — https://us.opencv.fr/docs

## Other Seventh Sense APIs (4)

- [Seventh Sense Collections API](https://apis.io/apis/seventh-sense/seventh-sense-collections-api/)
- [Seventh Sense Face Verification API](https://apis.io/apis/seventh-sense/seventh-sense-face-verification-api/)
- [Seventh Sense Persons API](https://apis.io/apis/seventh-sense/seventh-sense-persons-api/)
- [Seventh Sense Search API](https://apis.io/apis/seventh-sense/seventh-sense-search-api/)

## Tags

Face Anti-Spoofing / Liveness

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/seventh-sense/seventh-sense-face-anti-spoofing-liveness-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/seventh-sense/.