swan.ai.faceMatch

基础库 3.20.11 开始支持,低版本需做兼容处理。

解释:人脸对比,支持两张人脸图片的相似度对比,图片类型可以为:生活照,证件照,身份证芯片照或者带网纹照。使用本功能需要小程序开发者后台登录超级管理员账号,点击云平台付费链接开通云账号付费功能。
Web 态说明:受宿主环境限制,Web 态暂不支持 AI 能力相关接口。在 Web 态会做 打开百度 App 对应小程序页面 的降级处理。

方法参数

Object object

object 参数说明

属性名类型必填默认值说明

data

Array

图片信息

success

Function

接口调用成功后的回调函数

fail

Function

接口调用失败的回调函数

complete

Function

接口调用结束的回调函数(调用成功、失败都会执行)

data 参数

参数名参数类型是否必填说明

image

String

图片信息(总数据大小应小于 10M),图片上传方式根据 image_type 来判断。注意:
· 图片尺寸建议:1920 * 1080 以内
· 支持格式:支持 jpg、jpeg、png、bmp,不支持 gif 图

image_type

String

图片类型。
· BASE64:图片的 base64 值,base64 编码后的图片数据,编码后的图片大小不超过 2M
· URL:图片的 URL 地址(可能由于网络等原因导致下载图片时间过长)
· FACE_TOKEN:人脸图片的唯一标识,调用人脸检测接口时,会为每个人脸图片赋予一个唯一的 FACE_TOKEN,同一张图片多次检测得到的 FACE_TOKEN 是同一个

quality_control

String

图片质量控制。
· NONE:不进行控制
· LOW:较低的质量要求
· NORMAL:一般的质量要求
· HIGH:较高的质量要求;默认 NONE,若图片质量不满足要求,则返回结果中会提示质量检测失败

liveness_control

String

活体检测控制。
· NONE:不进行控制
· LOW:较低的活体要求(高通过率 低攻击拒绝率)
· NORMAL:一般的活体要求(平衡的攻击拒绝率,通过率)
· HIGH:较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE,若活体检测结果不满足要求,则返回结果中会提示活体检测失败

face_type

String

人脸的类型。
· LIVE 表示生活照:通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等
· IDCARD 表示身份证芯片照:二代身份证内置芯片中的人像照片
· WATERMARK 表示带水印证件照:一般为带水印的小图,如公安网小图
· CERT 表示证件照片:如拍摄的身份证、工卡、护照、学生证等证件图片;默认 LIVE

success 返回参数说明

参数名参数类型说明

score

Number

人脸相似度得分,推荐阈值 80 分

face_list

Array

人脸信息列表

face_list 参数说明

参数名参数类型说明

face_token

String

人脸的唯一标志

示例

跳转编辑工具

在开发者工具中打开

在 WEB IDE 中打开

扫码体验

代码示例

百度智能小程序

请使用百度APP扫码

图片示例

swan.ai.faceMatch - 图2

swan.ai.faceMatch - 图3

代码示例

  • JS
  1. Page({
  2. faceMatch() {
  3. // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
  4. let host = swan.getSystemInfoSync().host;
  5. if (host === 'baiduboxapp') {
  6. swan.ai.faceMatch({
  7. data: [{
  8. "image": "https://www.downloadImage.com/xxxx.jpg",
  9. "image_type": "URL",
  10. "face_type": "LIVE",
  11. "quality_control": "LOW",
  12. "liveness_control": "HIGH"
  13. },
  14. {
  15. "image": "https://www.downloadImage.com/xxxx.jpg",
  16. "image_type": "URL",
  17. "face_type": "IDCARD",
  18. "quality_control": "LOW",
  19. "liveness_control": "HIGH"
  20. }],
  21. success: res => {
  22. console.log('res');
  23. },
  24. fail: err => {
  25. console.log('err');
  26. }
  27. });
  28. }
  29. else {
  30. swan.showToast({
  31. title: '此api目前仅可在百度App上使用',
  32. icon: 'none'
  33. });
  34. }
  35. }
  36. });

返回值示例

  • JSON
  1. {
  2. "score": 44.3,
  3. // 返回的顺序与传入的顺序保持一致
  4. "face_list": [
  5. {
  6. "face_token": "fid1"
  7. },
  8. {
  9. "face_token": "fid2"
  10. }
  11. ]
  12. }