被动人脸活体检测

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

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

• 价格0.3 IC每次请求
• 月度套餐起价650泰铢/月
• 实测300/300
• 累计调用6M次

• v1.8
• 运行中
• 基准报告 (PDF)

输入

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"
}

月度套餐

• Face S每月 2,000 次每月 650 泰铢，折合每次 0.325 泰铢
  或每年 6,500 泰铢，省两个月订阅
• Face M每月 10,000 次每月 3,000 泰铢，折合每次 0.3 泰铢
  或每年 30,000 泰铢，省两个月订阅
• Face L每月 50,000 次每月 13,750 泰铢，折合每次 0.275 泰铢
  或每年 151,250 泰铢，省一个月订阅

价格不含 7% 增值税。人脸核验与活体检测的所有端点都计入套餐；超出部分每次从积分余额扣 0.3 积分（即按量价格）。按月或按年自动扣卡续订，可随时取消，期末生效。

请求

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

请求头

apikeystring必填

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

请求体

filefile必填

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

端点	返回
/v3/store/ekyc/face-passive-liveness	判定结果，经 iBeta 按 PAD 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 仍可用，价格相同。

响应

predictstring

REAL 或 SPOOF，由归一化分数得出

scorenumber

判定结果的归一化分数，0 至 1

normalizeddata

归一化后与归一化前的 REAL 和 SPOOF 分数

normalized.REALnumber

normalized.SPOOFnumber

darknessnumber

图像的暗度，0 至 1

filenamedurationstatus_codemessage

文件名；秒；成功时为 200 与 SUCCESS

详情

实测

2026 年 10 月 28 日经公开 API 在生产环境测得：公开基准 CelebA-Spoof 官方测试集中的 300 张攻击图像（10 类攻击，每类 30 张）和 200 张真人图像，以及来自 3 个公开样本集的 69 张真实手机自拍。

指标	结果
被当作真人接受的攻击，10 类共 300 张	0 张（APCER 0.0%，95% 上限 1.0%）
打印照片、海报、A4 打印（90 张）	接受 0 张
纸质面具：全脸、上半身、局部镂空（90 张）	接受 0 张
电脑、平板或手机屏幕回放（90 张）	接受 0 张
3D 面具（30 张）	接受 0 张
被拒绝的真实手机自拍，69 张	3 张（4.3%，95% CI 0.0–10.1%）
被拒绝的 CelebA-Spoof 真人图像，200 张网络照片	79.5%
经 API 的中位耗时	0.34 秒

判定偏严：基准中的真人图像是从网络收集的名人照片，被拒绝 79.5%，而手机自拍为 4.3%，因此请在您的应用中用摄像头拍摄自拍，而不是接受用户上传的文件。每类攻击 30 张、自拍 69 张，置信区间较宽，且两组数据都不专门代表泰国用户。方法与限制：基准测试报告 (PDF)。

呈现攻击检测另经 iBeta 按 PAD Level 1 测试：确认函 (PDF)。

限制

• 每张图像一张脸。
• 适用于摄像头现场拍摄的照片；相册或网络中的照片很可能被判为 SPOOF。
• 过暗而无法判定的图像不返回判定，消息为 THIS_IMAGE_IS_DARK；请让用户在光线充足处重拍。

数据处理

图像在内存中处理，响应返回后不保留。iApp 不保留副本；依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。