API

FPT.AI Reader - Xác thực khuôn mặt

Quy định

• Phải là ảnh có định dạng jpg hoặc jpeg
• Ảnh đầu vào không vượt quá 5 MB và độ phân giải tối thiểu khoảng 640x480 để đảm bảo tỉ lệ đọc chính xác
• Tỉ lệ diện tích khuôn mặt phải chiếm tối thiểu ¼ tổng diện tích ảnh.

Ảnh tiêu chuẩn

Ảnh kém chất lượng

• Ảnh chất lượng thấp và thiếu góc

• Ảnh chất lượng thấp và thiếu thông tin

Request

Request Url

POST https://api.fpt.ai/dmp/checkface/v1/

Request Headers

Tham số	Yêu cầu	Mặc định	Mô tả
api_key	Có		api_key của bạn ( lấy từ console.fpt.ai )

Request Body

FormData chứa 2 ảnh cần kiểm tra

Tham số	Yêu cầu	Mô tả
file[]	có
file[]	có

Chú ý: trường "file[]" thêm 2 lần

Sample Request

curl --location --request POST 'https://api.fpt.ai/dmp/checkface/v1' \
--header 'api_key: xxxxxxxxxxxxxxxx' \
--form 'file[]=/path/to/file1' \
--form 'file[]=/path/to/file2'

Response

JSON

• isMatch: thể hiện 2 ảnh có cùng 1 người hay không (dựa trên ngưỡng 80%)
• similarity: độ giống nhau của 2 ảnh
• isBothImgIDCard: thể hiện 2 ảnh có phải cùng là ảnh chứng minh nhân dân

{
    "code" : "200",
    "data" : {
        "isMatch": false,
        "similarity": 21.25160789489746,
        "isBothImgIDCard": false
    },
    "message": "request successful."
}

Response Code

Code	ý nghĩa
200	Thành công
407	Không nhận dạng được khuôn mặt
408	Ảnh đầu vào không đúng định dạng
409	Có nhiều hoặc ít hơn số lượng (2) khuôn mặt cần xác thực

Sample Response: Success

{
    "code" : "200",
    "data" : {
        "isMatch": false,
        "similarity": 21.25160789489746,
        "isBothImgIDCard": false
    },
    "message": "request successful."
}

Sample Response: Error

{
    "code": "409",
    "data": "Please upload only 2 images for face check",
    "message": "request successful."
}