腾讯云神图·人脸识别（Face Recognition）常见问题的解答

腾讯云人脸识别简介

腾讯云神图·人脸识别（Face Recognition）基于腾讯优图强大的面部分析技术，提供包括人脸检测与分析、五官定位、人脸搜索、人脸比对、人脸验证、人员查重、活体检测等多种功能，为开发者和企业提供高性能高可用的人脸识别服务。 可应用于智慧零售、智慧社区、在线娱乐、智慧楼宇、在线身份认证等多种应用场景，充分满足各行业客户的人脸属性识别及用户身份确认等需求。 

本文提供关于腾讯云人脸识别服务的一些常见问题的解答，如果您在使用过程中遇到问题，可以参阅产品文档中心的 常见问题。

腾讯云人脸识别功能

人脸检测与分析

对给定的人脸图片，检测人脸位置、人脸面部属性（包括性别、年龄、表情、魅力、眼镜、发型、口罩、姿态）、人脸质量信息（包括整体质量分、模糊分、光照分、五官遮挡分）。了解详情>>

五官定位

对请求图片进行人脸关键点定位，计算眉毛、眼睛、鼻子、嘴巴、脸型轮廓、眼珠等90个关键点。了解详情>>

人脸比对

对给定两张图片中的人脸进行相似度比对，返回人脸相似度分数，实现1:1比对。了解详情>>

人脸搜索

对给定一张人脸照片，和已有人脸库中的N个人脸进行比对，找出最相似的一张脸或多张脸，并给出相似度排序，实现1 : N或M：N搜索。了解详情>>

以下提供关于腾讯云人脸识别服务的一些常见问题的解答，如果您在使用过程中遇到问题，可以参阅产品文档中心的 常见问题。

腾讯云神图·人脸识别 接入和访问

人脸识别接入是否需要申请？

需要申请。您可登录 人脸识别控制台，单击立即开通即可使用，无需等待人工审核。

人脸识别可以在哪些国家和地区使用？

人脸识别目前在中国可以正常访问。其他国家也可调用接口访问，但访问速度较慢。

人脸识别的访问速度是多少？

通常在200ms-1s左右，具体响应时间也与照片大小以及网络环境有关。

如何鉴权/签名，或出现 AuthFailure.SignatureFailure 签名错误怎么办？

• 如果使用 SDK 进行 API 调用，检查是否调用了其它业务的接口。强烈建议使用 SDK 进行调用，SDK 内含生成签名的代码，避免自行组装复杂的签名逻辑。
• 若出现以下报错：TencentCloudSDKException：AuthFailure.SignatureFailure-The provided credentials could not be validated because of exceeding request size limit, please use new signature method TC3-HMAC-SHA256，原因是默认的签名方式不支持大文件，请根据提示指定新的签名方式 clientProfile.setSignMethod(ClienProfile.SIGN_TC3_256)。

报错后端服务超时（FailedOperation.RequestTimeout）怎么处理？

• API 接口调用超时是5秒，其中包含网络传输时间和服务器处理时间。
• 建议业务逻辑控制图片大小，大小具体值与网络状况和图片/视频内容复杂度相关，难以给出参考值，一般来说，人眼能清晰分辨即可，不必过于追求清晰大图。
• 如果是在线图片，建议把图片存储在腾讯云对象存储 COS 中，可以极大地减少网络传输时间，且更加稳定。

如何不写代码，快速体验各个接口功能？

打开API Explorer ，在页面左侧选择相应的接口，再填写相应参数即可发起接口调用。

是否支持 HTTP 访问？

仅支持 HTTPS 访问，不支持 HTTP 访问。

如何快速生成工程 SDK 的示例代码？

打开 API Explorer，在页面左侧选择相应的接口，再填写相应参数，页面会生成 SDK 使用示例代码，将代码复制即可使用。

SDK 接入后提示类找不到怎么处理？

检查项目中引入的版本号，确认是最新版本。

• Python：
  更新到最新版本：pip install -U tencentcloud-sdk-python。
• Java：
  Maven 仓库中查看最新版本号，并更新项目中引入的版本号。
• PHP：
  Composer 仓库中查看最新版本号，并更新项目中引入的版本号。
• Golang：
  安装/更新到最新版：go get -u github.com/tencentcloud/tencentcloud-sdk-go。
• Node.js：
  更新到最新版：npm update tencentcloud-sdk-nodejs --save。
• NET：
  Nuget 仓库查看最新版本号，并更新项目中引入的版本号。

SDK 依赖第三方组件，若是下载 SDK 文件引入到项目中，请检查第三方依赖是否也同时引入了。

我的开发环境要使用网络代理如何处理？

若您的网络环境需要代理才能访问公网，则需要在 SDK 中进行相应的设置。
假设代理服务器地址为127.0.0.1，代理端口为8080，设置例子如下：

• Java SDK：
  System.setProperty("https.proxyHost", "127.0.0.1")
  System.setProperty("https.proxyPort", "8080")
• Python SDK：
  os.environ['https_proxy'] = '127.0.0.1:8080'

基于 .NET SDK 开发应用，界面卡死如何处理？

把同步调用改为异步调用，具体参考 基于 API 3.0 开发 C# Windows Forms 应用。

腾讯云神图·人脸识别 计费和账单

人脸识别如何收费？

人脸识别分为云 API 调用次数计费和离线 SDK 按授权付费。具体可参考 计费概述。

人脸识别是否有免费额度支持？

有。人脸识别每个服务（按照相关接口维度）在每个自然月以免费资源包的形式享有1万次的免费额度。超过免费资源包额度后，将扣除付费资源包（若有）或进入后付费。

哪些错误码需要收费？

错误码 InvalidParameterValue.NoFaceInPhoto（图片中没有人脸）收费，其他错误码均不收费。

人脸搜索相关

人脸搜索支持创建多少 Group 和人脸规模？

1个 APPID 下最多创建10万个人员库（Group）、最多包含5000万张人脸（Face）。

不同算法模型版本（FaceModelVersion）的人员库（Group）最多可包含人脸（Face）数不同。算法模型版本为2.0的人员库最多包含100万张人脸，算法模型版本为3.0的人员库最多可包含300万张人脸。

支持在不同的 Group 创建同一个 Person 吗？

不支持，PersonId 以 APPID 账户为区分界限，不以 Group 为区分界限，因此当需要同一人属于不同的 Group 时，可采用 复制 Person（非创建）。

可以同时支持多少个 Group 进行搜索？

建议不超过100个。

执行删除 Group，其中有人属于不同的 Group，会都删除吗？

不会，若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除。

执行删除 Person，如该 Person 属于多个 Group，会都删除吗？

会，删除该人员信息，此操作会导致所有人员库均删除此人员。

人脸搜索的推荐阈值是多少？

• 1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分；
• 10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分；
• 30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。

一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。

人脸搜索功能每秒可以处理多少张图片？

通常100W的人脸库在1s以内，具体搜索时间与网络环境及人脸库大小有关。

人脸搜索支持跨库搜索吗？

支持。人脸搜索可在参数 GroupIds 输入 GroupId 数组，进行跨组搜索。

人脸搜索如何收费？

人脸搜索按调用接口次数收费。如一个组里面有 N 个人，每个人有 M 张照片，不管一次检索了库里多少张人脸，都按调用接口的次数收费。

人脸静态活体检测相关

静态活体检测的置信度为多少时，会被判断为真人？

• 2.0算法模型版本，建议置信度设置在87；
• 3.0算法模型版本，请直接使用出参中的 IsLiveness 字段。

建议使用3.0算法模型版本。

静态活体检测是否支持视频识别？

只支持检测静态照片，建议将视频截帧识别。

静态活体检测可以应用在哪些场景中？

建议用于对防攻击要求不高的场景。对安全性要求高的建议使用唇语活体检测。此外，推荐在手机自拍场景使用为佳，非手机自拍场景，活体分数参考价值大大降低。

人脸识别版本相关

目前有多少版本？不同版本区别是什么？

腾讯云神图·人脸识别目前共有3个版本，分别为1.0、2.0和3.0。2.0和3.0为当前开放的版本，可正常使用。1.0版本目前仅支持老客户使用，新客户无法使用1.0版本。具体区别如下：

• 接口域名：接口请求域名不同。2.0和3.0版本的接口域名为 iai.tencentcloudapi.com，支持云 API 3.0规范。1.0版本的接口域名为 recognition.image.myqcloud.com 和 service.image.myqcloud.com。
• 人脸特征数据：不同版本的人员库数据互不相通，不可以混淆使用，无法通过人脸搜索或人脸验证相关接口混用不同版本的人员库。
• 算法模型：不同版本的算法模型不同，新版本的算法模型统计意义上效果更优。

如何查看目前正在使用哪个版本？

• 如果您使用的接口域名为iai.tencentcloudapi.com，无状态接口（如 人脸检测与分析 、人脸比对、人脸静态活体检测），您可以通过 FaceModelVersion 参数控制希望使用的算法模型版本为2.0还是3.0 。有状态接口（如 人员库管理相关接口、人脸搜索相关接口、人脸验证相关接口等），您可以通过 获取人员库列表 查看人员库的算法模型版本信息。
• 如果您使用的接口域名为recognition.image.myqcloud.com 或 service.image.myqcloud.com，则为1.0版本。

是否可以继续使用人脸识别旧版本？

人脸识别1.0版本已从2019年6月21日起停止维护，如果您用的还是1.0版本的服务，为了不影响您业务的正常开展，建议您尽快迁移。

人脸识别2.0及以后版本我们均会持续正常维护和迭代，请放心使用。

是否支持批量导出老版本的人脸照片？

没有工具可以批量导出，需要您手动整理人员照片。

希望使用新算法模型版本该如何操作？有哪些注意点？

如果您当前使用2.0版本，希望使用3.0版本，您需要重新创建人员库并完成人员入库。我们将于2020年6月提供算法模型升级接口，届时您可以无需通过新建人员库来完成算法模型升级。 

离线识别 SDK 相关

离线识别 SDK 测试申请审批需要多久？

1个工作日。

测试有效期多久，测试授权到期后怎么办？

测试有效期2个月，可在 测试申请 文档中查看测试续期延长测试时间。

测试版绑定设备的数量是否有限制，如何增加设备数量？测试版绑定设备的数量是否有限制，如何增加设备数量？

测试版限制绑定3台设备，可在 测试申请 文档中查看测试续期增加设备数量。

测试期间 SDK 能力申请错了，或想增加能力，怎么办？

测试期间可在 测试申请 文档中查看测试续期修改 SDK 能力。

支持哪些平台？

支持 Android、ARM Linux（海思 dv300）、Windows（C++）等计算平台。

是否支持口罩识别？

支持。

是否支持脸部各部位遮挡判断？

判断遮挡：使用人脸精确配准模块（YTFaceAlignment），支持判断左右眼睁闭眼、左右眼/左右眉/嘴巴/鼻子/左右脸/下巴遮挡。

是否返回脸部旋转角度，带低头、斜视等状态监测？

判断旋转：使用人脸追踪模块（YTFaceTracker），返回脸部旋转角度，可根据业务实际场景测试效果进行修改设置，如人脸正对时值为0，完全侧脸值为正负90，可对低头等脸部旋转进行监测，斜视未监测。

是否支持人脸质量分判断？

质量分筛选：使用人脸质量模块（YTFaceQuality），支持质量判断后优选照片。

收费模式？

测试授权免费试用，正式授权收费模式为一次性授权收费，永久使用。单价方面，根据采购数量阶梯算价，可参考
计费概述 > 离线识别 SDK。

是否有通过 BCTC 银联卡检测中心的认证呢？

有，若人脸支付场景，请联系小助手（微信号：TencentCloudSunny）对接过检了 BCTC 的人脸支付专属 SDK。

有没有推荐的硬件设备？

芯片只要是 ARM 架构的 CPU 都支持，推荐 RK3399 ；摄像头推荐华捷艾米 A200CPSV7 A200+mini（3路输出，竖版，支持彩色+红外+深度）；内存（RAM）建议大于2GB。

授权是否需要联网？

运行 SDK 需要联网一次进行授权，成功后可离线运行。

离线 SDK 和在线 API 调用的有什么区别？

离线人脸识别 SDK 授权后，运行无需网络，人脸检测/识别均运行在设备端本地，响应时间会比在线 API 调用更短从而达到实时，且可以节省流量无需占用带宽；在线 API 调用需要将图片上传到云端，并且通过网络返回，整个识别流程依赖于网络，其应对弱网环境，或者对响应速度要求苛刻的环境下，表现不如离线方案。

人脸库是怎样储存的？

程序重新启动需要重新加载吗？ 人脸库储存人脸特征，为 float[] 数据，可以根据业务实际情况，选择多种存储方式，例如文件、数据库、需要在程序启动时重新调用 insertFeatures 进行加载。

人脸比对 YTFaceRetrieval 的 compare 多少分认为是同一个人？

取决于不同版本提特征模型 faceFeature 的阈值。例如，人脸比对 YTFaceRetrieval-Android-v2.1.0 中使用了 YTFaceFeature-Android-v3.0.1-v703 ，使用了提特征 faceFeature 的 v703 模型，推荐阈值为80可认为是同一人，具体阈值大小，可根据业务实际场景测试效果进行修改设置。

调用人脸检测 YTFaceTracker、人脸比对时 YTFaceRetrieval，返回 so 库的内存地址错误，表现为闪退，log 日志显示“signal 11 ... fault addr”？

原因可能是在调用人脸检测、人脸比对等方法时传入不正确的参数值导致的，如长度为0的数组或者 null。建议断点下所有调用 SDK 底层方法的入参是否正确，或者关键地方打下 log 看。

例如：  

1、YTFaceTracker.track(data) 的 data 仅能是 rgb 格式。而 Android 相机的 data 默认是 yuv 格式。 

2、在切换界面时没有 destory() 掉算法，导致一直在运行。如，进入下一个界面后前一个界面的 destroy 还没执行到，处理算法模型的 heavy 线程还在运行，特征点提取就传入了空值。

使用 YTFaceTracker.detect() 一直获取不到人脸，有可能是图片格式问题？

SDK 底层算法需要的图片格式是 RGB888，可先确认图片格式或者用 YTUtils 工具方法进行转换。

过滤不符合要求的人脸、姿势要求和检测人脸的最小值是多少？

这些参数没有确切值的设置。 demo 工程中设定的值是比较合理的，可根据业务实际场景测试效果进行修改设置。

手机设备序列号如何获得？

• 机连接电脑，然后在控制台用 adb 命令查看：adb shell "getprop | grep serial"，一般而言，序列号为 "ro.serialno" 对应值；部分三星手机，序列号为 "ril.serialnumber" 对应值。
• 在设备上选择【设置】>【关于手机】>【状态】里面查看【序列号】（不同系统可能稍有区别）。

人脸录入多端同步是如何实现的？

腾讯云为您提供三个参考方案：

• 服务器下发图片到每一台 Android 设备上，每一台 Android 设备独自执行提取特征注册人脸。
• 使用一台 Android 设备专门用于提取特征，然后通过服务器或者其他方式分发人脸特征到其他的 Android 设备上。
• 直接申请接入腾讯云 人脸识别门禁考勤解决方案（线上在线采集，线下离线识别，多终端同步管理）。

人脸库规模？

最大规模支持3W的储存量，推荐1万储存，可实现毫秒级结果返回：在 RK3399 上测试1:10000平均响应时间是100+ms，若人脸库远大于3W，推荐采用端+云的方案，即采用本地人脸检测、活体检测等筛选采集操作，再请求云端进行人脸库搜索匹配。

更多问答，请参阅帮助文档中心

人脸核身中的活体检测，微信h5接入模式是否需要自行开发界面？

pytorch运行时错误？

人脸识别接口在STM32单片机上的实现？

AuthFailure.SignatureFailure签名失败？

腾讯云人脸识别-微信小程序-工具类小程序是否可以申请？