id-document-liveness-detection

<p align="center"> <a href="https://play.google.com/store/apps/dev?id=7086930298279250852" target="_blank"> <img alt="" src="https://github-production-user-asset-6210df.s3.amazonaws.com/125717930/246971879-8ce757c3-90dc-438d-807f-3f3d29ddc064.png" width=500/> </a> </p>

Product & Resources

For more information, visit KBY-AI's GitHub Repository.

SDK License

This Docker image utilizes KBY-AI's SDK, which requires a license for each machine or instance on which it runs.

• To get the machine code (HWID) for license, use the following syntax:

sudo docker run -e LICENSE="xxxxx" kbyai/idl:latest

• To request the license, please provide us with the machine code (HWID) obtained from your console.

Contact us:</br>

🧙Email: [email protected]</br> 🧙Telegram: @kbyaisupport</br> 🧙WhatsApp: +13348402323</br> 🧙Discord: KBY-AI</br> 🧙Teams: KBY-AI</br>

Test API with Gradio Demo

To test the Gradio demo from the Docker image, access it at http://127.0.0.1:7860 or http://localhost:7860.

<img alt="Gradio Demo" src="https://github.com/user-attachments/assets/ccbbe118-5522-41e5-86f2-2b0b7854cfa0" width=1000/>

API Instruction

API can be tested through Postman based on the following endpoint details.</br>

1. Processing Image with File

• API endpoint: <base URL>/process_image
• Method: POST
• Content-type: multipart/form-data
• Request Parameters:

  Parameter	Type	Description
  image	File	ID document image file with *.jpg or *.png extension

• Request example</br>

2. Processing with Base64-Encoded String

• API endpoint: <base URL>/process_image_base64
• Method: POST
• Content-type: application/json
• Request Parameters: </br>

  Parameter	Type	Description
  base64	String	The base64-encoded string of the ID document image

• Request example</br>

API Response Description in JSON

1. portraitReplace:

• Type: Float
• Description: A score indicating the likelihood that the portrait on the ID document has been tampered with or replaced. Higher values (closer to 1) suggest the portrait is likely original, while lower values may indicate potential tampering.</br>

2. printedCopy:

• Type: Float
• Description: A score that assesses whether the document is a printed copy rather than an original document. Values close to zero suggest the document might be a printed copy, while higher values indicate originality.</br>

3. screenReply:

• Type: Float
• Description: A score that determines if the document was displayed on a screen rather than being a physical ID. Lower values (closer to zero) imply a higher likelihood that the document is displayed on a screen.</br>

4. Result status:

• Type: String
• Description: Indicates the status of the liveness check on the document. "Ok" typically means that the document passed initial verification. Other statuses could indicate different levels of authenticity or potential issues with the document.</br>
• Status: Ok, Too close to camera!, Too close to border!, Document cropped!, Too small!, Multiple documents, Is Colorless!, Document not found!, Unknown
• Resonpse Example:

{
    "result": {
        "portraitReplace": 0.590566158294678,
        "printedCopy": 2.0435e-11,
        "screenReply": 0.002031173091382,
        "status": "Ok"
    },
    "resultCode": "Ok"
}