人脸比对

比较两张图像中的人脸，判断是否为同一人，并返回相似度分数和判定所用的阈值。

POST/v3/store/ekyc/face-verification试一试

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

• v2.0
• 运行中

输入

输出POST /v3/store/ekyc/face-verification

duration

2.1263949871063232

matched

true

message

successfully performed

score

38

threshold

37

全部字段见“响应”一节

请求

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

响应

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

{
    "duration": 2.1263949871063232,
    "matched": true,
    "message": "successfully performed",
    "score": 38.0,
    "threshold": 37
}

请求

multipart/form-data，每次两张图像，每张一张脸。

请求头

apikeystring必填

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

请求体

file1file必填

第一张脸。JPEG、PNG、HEIC 或 HEIF，或 Base64；至少 600 × 400 像素，最大 2 MB。

file2file必填

第二张脸，限制相同。

thresholdnumber

达到此分数即判定匹配。默认 36，对应 99.50% 精确率；48 对应 99.95%，误接受率极低。

旧路径 /face-verification、/face-verification/v2、/face2 与 /face_compare 仍可用，价格相同。

响应

matchedboolean

score 是否达到 threshold

scorenumber

相似度，0 至 2822，越高越相似

thresholdinteger

所用阈值

durationmessage

秒；successfully performed

状态码

代码	含义
413	某张图像超过 2 MB
415、442	不支持的文件格式
420	缺少必填参数
423	图像中未找到人脸
440	未附加文件
441	图像数量过多
560	服务器繁忙，请重试
561、562	处理或排队超时

详情

实测

限制

• 角度、光线不足和遮挡会降低分数；清晰、光线充足、无遮挡的人脸得分最高。

数据处理

图像仅转换为数值特征用于比对，响应返回后不保留。服务符合 GDPR 与 PDPA。