被动人脸活体检测

SDK 以一次类型化调用封装经 iBeta PAD Level 1 测试的被动人脸活体检测 API：提交一张人脸图像，即可判断是真人活体还是伪造（打印照片、面具、屏幕翻拍或视频重放），每次请求 0.3 IC。如需基于挑战的在场证明，请使用主动人脸活体检测。

调用

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

final result = await client.checkPassiveLiveness(file: selfieBytes);

if (result.predict == 'REAL') {
  // Genuine live face
}

Web

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const result = await ekyc.passiveLiveness({ file: selfieBlob });

if (result.predict === 'REAL') {
  // Genuine live face
}

iOS / Android / React Native

原生封装通过 faceCapture 流程自动拍摄清晰的正脸自拍；请从您的应用或后端把返回的 JPEG 提交给此 API。

安装：Flutter 与 Web 见入门指南，原生封装与相机权限见 iOS, Android & React Native。

结果

响应与 API 一致：predict（REAL 或 SPOOF）、score、darkness 以及原始分数明细。字段列表见被动人脸活体检测 API。

数据处理与重试

• 图像只保留在内存中，且只发送到配置的 baseUrl；SDK 从不将其写入磁盘。
• 这是计费调用：请求正文发出后，SDK 不会自动重试。

本 SDK 为开源项目：github.com/iapp-technology/iapp-ekyc-sdk。