Documentation

Documentation

  • Conversation
  • Reader
  • Speech
  • Console
  • Languages iconTiếng Việt
    • English
    • Janpanese

›API

Tổng quan

  • Nhận diện Bằng Lái Xe
  • Nhận diện CMT/CCCD
  • Nhận diện Hộ Chiếu
  • Xác thực khuôn mặt
  • Tìm kiếm khuôn mặt
  • Reader
  • SDK FPT.AI eKYC
  • Nhận diện tính sống

API

  • Nhận diện Bằng Lái Xe
  • Nhận diện CMT/CCCD
  • Nhận diện Hộ Chiếu
  • Tìm kiếm khuôn mặt
  • Xác thực khuôn mặt
  • Nhận diện tính sống

Hướng dẫn

  • Nhận diện Bằng Lái Xe
  • Nhận diện CMT/CCCD
  • Nhận diện Hộ Chiếu
  • Tìm kiếm khuôn mặt
  • Xác thực khuôn mặt
  • SDK eKYC
  • Nhận diện tính sống

API

FPT.AI Reader - Liveness Detection

Quy định ảnh đầu vào

Đối với video

  • Video đầu vào không vượt quá 10 MB và độ phân giải tối thiểu khoảng 800x600 để đảm bảo độ chính xác

  • Tỉ lệ diện tích mặt phải phải chiếm tối thiểu 3/5 tổng diện tích video trở lên

  • Độ dài video từ 5-10s

Đối với hình ảnh gửi kèm (để so sánh khuôn mặt)

  • Ảnh muốn so sánh với frame trong video không vượt quá 5 MB và độ phân giải tối thiểu khoảng 800x600.

  • Tỉ lệ diện tích mặt phải phải chiếm tối thiểu 3/5 tổng diện tích ảnh trở lên

Ảnh tiêu chuẩn

1

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

  • Ảnh chất lượng thấp hoặc mặt bị che
  • Video bị mờ, quay với camera chất lượng thấp

Thông tin API

Request Url

POST https://api.fpt.ai/dmp/checklive/v2

Request Headers

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

Request Body

FormData chứa video và ảnh cần kiểm tra

Tham sốYêu cầuMô tả
videocóVideo quay lại cử động tự nhiên của khuôn mặt khách hàng
cmndkhôngẢnh muốn so sánh với khuôn mặt thẳng nhất trong video

Sample Request

curl --location --request POST 'https://api.fpt.ai/dmp/checklive/v2' \
--header 'api-key: xxxxxxxx' \
--form 'video=@"/video.mp4"' \
--form 'cmnd=@"/face.jpg"'

Response

JSON

{
    "code": "200",
    "message": "request successful.",
    "is_live": true,
    "prob": "0.006677149",
    "need_to_review": false,
    "is_deepfake": false,
    "deepfake_prob": "0.0016087113",
    "face_match": {
        "isMatch": false,
        "similarity": 1.8187788133647025
    },
    "face_match_error": {}
}

Các thông tin trả về

TrườngMô tả
codeMã kết quả/lỗi
is_liveKết quả xác thực video
is_deepfakeKết quả kiểm tra video có dùng deepfake không
face_matchKết quả so khớp khuôn mặt
face_match_errorLỗi (nếu có) khi so khớp khuôn mặt

Mã Code

CodeÝ nghĩa
200Không có lỗi, xem thêm kết quả trong các trường ở trên
408Trong video có 2 mặt người trở lên
409Không có file video gửi lên/Sai extension
410Trong video không có mặt người
411Kích thước khuôn mặt quá bé
412Mặt quá mờ
413Video là ảnh tĩnh

Sample Response: Success

{
    "code": "200",
    "message": "request successful.",
    "is_live": true,
    "prob": "0.006677149",
    "need_to_review": false,
    "is_deepfake": false,
    "deepfake_prob": "0.0016087113",
    "face_match": {
        "isMatch": false,
        "similarity": 81.81878813647025
    }
}

Sample Response: Error

{
    "code": "200",
    "message": "request successful.",
    "is_live": true,
    "prob": "0.006677149",
    "need_to_review": false,
    "is_deepfake": false,
    "deepfake_prob": "0.0016087113",
    "face_match_error": {
        "code": "407",
        "data": "No faces detected"
    }
}

{
    "code": "200",
    "message": "request successful.",
    "is_live": true,
    "prob": "0.1212767",
    "need_to_review": true,
    "is_deepfake": true,
    "deepfake_prob": "0.99999964",
    "face_match": {
        "isMatch": false,
        "similarity": 8.060021979547948
    }
}

{
    "code": "200",
    "message": "request successful.",
    "is_live": false,
    "prob": "0.9255054",
    "need_to_review": false,
    "face_match": {
        "isMatch": false,
        "similarity": 22.457926631125535
    }
}

{
    "code": "408",
    "message": "request successful.",
    "data": "2 faces"
}

{
    "code": "409",
    "message": "request successful.",
    "data": "Allowed extensions are  mov, mp4, mkv, webm"
}

{
    "code": "410",
    "message": "request successful.",
    "data": "No faces"
}

{
    "code": "411",
    "message": "request successful.",
    "is_live": false,
    "need_to_review": false
}

{
    "code": "412",
    "message": "request successful.",
    "is_live": false,
    "need_to_review": false
}

{
    "code": "413",
    "message": "request successful.",
    "is_live": false,
    "need_to_review": false
}

← Xác thực khuôn mặtNhận diện Bằng Lái Xe →
  • Quy định ảnh đầu vào
    • Đối với video
    • Đối với hình ảnh gửi kèm (để so sánh khuôn mặt)
  • Thông tin API
    • Request Url
    • Request Headers
    • Request Body
    • Sample Request
    • Response
Conversation
DocumentationAPI ReferenceTutorials (Video)
Reader
DocumentationAPI ReferenceTutorials
Speech
DocumentationAPI ReferenceTutorials
Copyright © 2023 FPT Corporation