人脸与身份证比对（KYC）

将自拍与身份证上的照片比对，判断是否为同一人，并给出每项检查及综合判定的置信度。

POST/v3/store/ekyc/face-and-id-card-verification

另有 2 个端点

试一试

• 价格1 IC每次请求
• 累计调用68.6K次

• v1.0
• 运行中

输入

输出POST /v3/store/ekyc/face-and-id-card-verification

idcard

confidence: 66.872 isSamePerson: true

selfie

confidence: 86.04 isSamePerson: true

time_process

0.824

total

confidence: 76.456 isSamePerson: true

全部字段见“响应”一节其他端点：/back, /front 见请求

请求

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification \
  -H "apikey: YOUR_API_KEY" \
  -F "file0=@id-card.jpg" \
  -F "file1=@selfie.jpg"

响应

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

{
    "idcard": { "confidence": 66.872, "isSamePerson": "true" },
    "selfie": { "confidence": 86.04, "isSamePerson": "true" },
    "time_process": 0.824,
    "total": { "confidence": 76.456, "isSamePerson": "true" }
}

请求

multipart/form-data，证件与自拍在同一请求中。

请求头

apikeystring必填

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

请求体

file0file必填

身份证，拍摄时须使证件照清晰可辨。JPEG、PNG 或 GIF，至少 600 × 400 像素，最大 10 MB。

file1file必填

持证人的自拍，限制相同。

端点	返回	价格
/v3/store/ekyc/face-and-id-card-verification	判定结果	每次请求 1 IC
/v3/store/ekyc/face-and-id-card-verification/front	判定结果，基于泰国身份证正面	每页 1 IC
/v3/store/ekyc/face-and-id-card-verification/back	同上，基于背面	每页 1 IC

旧路径 /face-verify-id2、/thai-national-id-card/v3/front/kyc 与 /thai-national-id-card/v3/back/kyc 仍可用，价格相同。

响应

idcardselfie

两项检查

idcard.confidencenumber

0 至 100

idcard.isSamePersonstring

totalobject

综合判定，其 confidence 为两项的平均值

total.confidencenumber

0 至 100

total.isSamePersonstring

time_processnumber

秒

状态码

代码	含义
413	某个文件超过 10 MB
415、442	不支持的文件格式
420	缺少 file0 或 file1
421	图像中未找到人脸或证件
422	证件上或自拍中未找到人脸
441	图像数量过多
461	未附加文件

详情

实测

指标	结果
误拒率	低于 3%
误受率	低于 0.1%

限制

• 自拍中只能有一张脸。

数据处理

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