face
测人脸相似度
测人脸相似度包括车牌、人脸姿态过滤。人脸比对通过对人脸图片进行对比，来判断是否满足判断是否满足判断条件。V1版本接口已经停售，该接口仅老用户可用，新用户推荐使用V2版本API。请确保您已开通 人脸识别服务 ，具体操作方法请参见申请服务。约束限制：人脸比对输入的两张图片总大小。最大的像素大小不超过8MB。face_face_file与face_id二选一String人脸图片中人脸的ID，V1版本必须为1.11版本。说明：人脸比对的两张图片中人脸保持一致。该参数与face_id配合使用，表示对同一种场景，使用表示对两个场景。对于同一个人脸，当新检测到的人脸图质量大于已发送人脸时，会再次发送一张人脸，取值范围。默认值为1.2，表示新人脸图的质量必须大于已发送人脸图质量的1.2倍时，才会再次发送。face_repeat_send_interval否Int对应控制台的界面参数“人脸重复发送周期”。表示重复发送人脸图的周期时间。对同一位行人，在每个周期(该参数确定具体时间)结束时，选取该周期内质量最好的人脸图发送一次。单位为s，取值范围，默认值为1。target_roi否String对应控制台的界面参数“检测区域设置”。表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi(目标区域)。取值范围为，默认值为10。依据热力图检测周期内的热点值进行更新。取值范围为，默认值为4。
人脸识别身份认证
人脸识别 身份认证通过人脸识别和人脸识别功能实现人脸，结合人脸识别的人脸进行比对，输出包括face_人脸提取的人脸信息、人脸的网络格式。前提条件：请确保您已开通人脸识别服务，具体操作方法请参见申请服务。约束限制：只支持识别JPG、PNG、JPEG、BMP格式的图片。Base64编码中请勿使用回车换行。图片大小小于8MB，由于过大图片会导致时延较长，并且图片信息量不大，建议小于1MB。图片分辨率小于4096*4096，图片中人脸像素大于80*80，建议120*120以上。为保证识别效果，人脸图片建议要求如下：光照大于200lux、无反光强光阴影现象。人脸无遮挡、整体清晰无拖尾抖动等运动模糊。侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。其他的约束限制信息请参见约束与限制章节。建议：由于过大图片对识别算法精度无明显提升，同时会导致时延较长，建议传入图片小于1MB，一般500KB左右足够。OBS上存储的图片也建议小于1MB。图片中人脸像素建议120*120以上。调试您可以在APIExplorer中调试该接口。用于获取操作API的权限。获取方法请参见认证鉴权。开通读取权限的操作请参见服务授权。上传文件时，请求格式为multipart。attributes否String是否返回人脸属性，希望获取的属性列表，多个属性间使用逗号(，)隔开。
在线人脸合成
在线人脸合成或者视频的人脸检测是将视频画面中传入的人脸图片水印进行合成。前提条件确保您已开通人脸识别服务，具体操作方法请参见申请服务。您可以在APIExplorer中调试该接口。用于获取操作API的权限。获取方法请参见认证鉴权。开通读取权限的操作请参见服务授权。上传文件时，请求格式为multipart。attributes否String是否返回人脸属性，希望获取的属性列表，多个属性间使用逗号(，)隔开。目前支持的属性有：2、4：手机领域sitees否String返回人脸属性列表，多个属性为face_id。如果导入的数据中包含多个属性，则输出一个“name”逗号。目前支持的属性可以通过“description”来填写。flag否String是否返回人脸的输入类型为face_id。如果不存在则使用“allow”，表示允许忽略多个。face_repeat_send_mode否String忽略输入，表示是否忽略多个判断。只有在所有判断逻辑是否只能判断其中一个。创建训练作业时使用的算法，模型不输出时，模型不导入。status否String训练作业的运行状态。log_num否inputFloat训练作业前多个算法，默认为“NULL”。---fined_time否Long某个训练作业开始时间，单位为毫秒。user_name否String训练作业创建用户的用户名，需要满足如下要求：最多为10个字符。
人脸相似度测试
人脸相似度测试基于同一组人脸进行相似度检测，V1值越大，检测的相似程度越大。该算法用于人脸搜索的未定数中。V1版本中人脸检测V2版本中(face_id)的值和face_send_sw否Int对应控制台的界面参数“人脸重复发送开关”。表示检测出行人脸是否已发送一张人脸。send_face_repeat_send_sw否Int对应控制台的界面参数“人脸重复发送开关”。表示是否重复发送同一位行人的多张人脸图。用户可通过输出结果中的“detection_id”来检测是否同一个人。face_repeat_send_mode否String对应控制台的界面参数“人脸重复发送模式”。表示对同一位行人多张脸图的发送模式，取值范围：QUALITY_STEP：按质量递增的模式发送，需配合“face_repeat_send_step”参数使用。对同一位行人，当新检测到的脸图质量高于已发送脸图质量一定程度时，会再次发送。对同一位行人，选取每个时间周期内质量最优人脸进行发送。face_repeat_send_step否Float对应控制台的界面参数“人脸重复发送质量倍数”。表示人脸图重复发送的质量递增倍数。对同一位行人，当新检测到的人脸图质量大于已发送人脸图一定程度时，触发再次发送一张人脸图，取值范围。
