被动人脸活体检测

仅凭一张图像判断人脸来自真人还是欺骗手段，如打印照片、仿真面具、屏幕翻拍或视频回放；主动活体检测在此基础上叠加设备端动作挑战。

POST/v3/store/ekyc/face-passive-liveness试一试

价格0.3 IC每次请求
累计调用6M次

v1.8
运行中

输入

file: selfie.jpg

输出POST /v3/store/ekyc/face-passive-liveness

filename: S__5333002.jpg
predict: SPOOF
score: 0.9999989633974822
darkness: 0.51
data: SPOOF: 0.9999990463256836 REAL: 9.35794162160164e-7
normalized: SPOOF: 0.9999989633974822 REAL: 0.0000010366025178232263
status_code: 200
duration: 0.35393
message: SUCCESS

全部字段见“响应”一节

请求

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-passive-liveness \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@selfie.jpg"

响应

200成功。字段在"响应"一节说明。

{
    "filename": "S__5333002.jpg",
    "predict": "SPOOF",
    "score": 0.9999989633974822,
    "darkness": 0.51,
    "data": {
        "SPOOF": 0.9999990463256836,
        "REAL": 9.35794162160164e-7
    },
    "normalized": {
        "SPOOF": 0.9999989633974822,
        "REAL": 1.0366025178232263e-6
    },
    "status_code": 200,
    "duration": 0.35393,
    "message": "SUCCESS"
}

请求

multipart/form-data，每次一张图像。两个端点均为每次请求 0.3 IC。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

人脸图像。JPEG、PNG、HEIC 或 HEIF，最大 10 MB。

端点	返回
`/v3/store/ekyc/face-passive-liveness`	判定结果，通过 iBeta Level 1 认证
`/v3/store/ekyc/face-passive-liveness/v1p10`	同上，来自 v1p10 模型

旧路径 /anti_face_spoofing、/api/v2/fas、/face-spoofing、/passive-face-liveness-detection 与 /v1p10/facial_anti_spoofing 仍可用，价格相同。

响应

详情

实测

指标	结果
判定正确，7,680 次测试	99.43%
呈现攻击检测	iBeta Level 1，确认函 (PDF)

限制

每张图像一张脸。

数据处理

图像在内存中处理，响应返回后不保留。服务符合 GDPR 与 PDPA。

请求​

响应​

详情​

请求

响应

详情