人脸水印照比对,对通过接口上传的人脸照片和一个人脸水印照片进行比对,来判断是否为同一个人。若上传的照片中包含 exif 方向信息,我们会按此信息旋转、翻转后再做后续处理。同时,我们还提供自动旋转功能,当照片方向混乱且 exif 方向信息不存在或不正确的情况下,服务会根据照片中人脸方向来检查可能正确的方向,并按照正确的方向提供人脸检测结果。
该能力是通过HTTP API的方式给开发者提供一个通用的接口,适用于一次性交互数据传输的AI服务场景,块式传输。相较于SDK,API具有轻量、跨语言的特点,不过请注意该接口使用的HTTP API协议不支持跨域。
示例demo请点击 这里 下载。
目前仅提供部分开发语言的demo,其他语言请参照下方接口文档进行开发。
也欢迎热心的开发者到 讯飞开放平台社区 分享你们的demo。
集成人脸水印照比对API时,需按照以下要求。
内容 | 说明 |
---|---|
请求协议 | http[s] (为提高安全性,强烈推荐https) |
请求地址 | http[s]: //api.xfyun.cn/v1/service/v1/image_identify/watermark_verification 注:服务器IP不固定,为保证您的接口稳定,请勿通过指定IP的方式调用接口,使用域名方式调用 |
请求方式 | POST |
接口鉴权 | 签名机制,见授权认证 |
字符编码 | UTF-8 |
响应格式 | 统一采用JSON格式 |
开发语言 | 任意,只要可以向讯飞云服务发起HTTP请求的均可 |
适用范围 | 任意操作系统,但因不支持跨域不适用于浏览器,请在后端调用接口 |
照片属性 | 宽必须大于8px,人脸照高度小于等于4000px,人脸水印照高度小于等于480px |
照片格式 | 水印照支持JPG/BMP/PNG/TIFF,人脸照还支持GIF |
照片大小 | 人脸照大小不超过5M,水印照大小不超过1M |
注: 若需配置IP白名单,请前往控制台。IP白名单规则请参照 IP白名单。
接口地址示例:
POST http[s]://api.xfyun.cn/v1/service/v1/image_identify/watermark_verification HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8
在调用该业务接口时
IP白名单规则
{
"code":"10105",
"desc":"illegal access|illegal client_ip",
"data":"",
"sid":"xxxxxx"
}
在 Http Request Header 中配置以下参数。
以下参数用于授权认证:
参数 | 格式 | 说明 | 必须 |
---|---|---|---|
X-Appid | string | 讯飞开放平台注册申请应用的应用ID(appid) | 是 |
X-CurTime | string | 当前UTC时间戳 从1970年1月1日0点0 分0 秒开始到现在的秒数 | 是 |
X-Param | string | 相关参数JSON串经Base64编码后的字符串,详见业务参数 | 是 |
X-CheckSum | string | 令牌,计算方法:MD5(APIKey + X-CurTime + X-Param),三个值拼接的字符串,进行MD5哈希计算(32位小写) | 是 |
注:
*X-CheckSum *生成示例:
String APIKey="abcd1234";
String X-CurTime="1502607694";
String X-Param="eyAiYXVmIjogImF1ZGlvL0wxNjtyYXR...";
String X-CheckSum=MD5(apiKey + X-CurTime + X-Param);
X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串,原始 JSON 串各字段说明如下:
参数 | 类型 | 必须 | 说明 | 示例 |
---|---|---|---|---|
auto_rotate | bool | 否 | 是否对图片进行自动旋转,true旋转,false不旋转,默认false | true |
X-Param生成示例:
原始JSON串:
{
"auto_rotate": True,
}
BASE64编码(即X-Param):
ewoJICAgICJhdXRvX3JvdGF0ZSI6ICJ0cnVlIiwKCX0=
以POST表单的形式提交以下参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
face_image | string | 是 | 需上传的人脸照,base64编码后进行URLEncode 格式必须为JPG(JPEG),BMP,PNG,GIF,TIFF之一 宽和高必须大于8px,小于等于4000px 要求原始图片大小不超过5M |
watermark_image | string | 是 | 需上传的水印照,base64编码后进行URLEncode 格式必须为JPG(JPEG),BMP,PNG,TIFF之一 宽和高必须大于 8px,小于等于480px 原始文件尺寸小于等于1MB |
java示例(可参考示例demo):
face_image = urlencode(base64(人脸照)) & watermark_image = urlencode(base64(水印照))
返回值为 json 串,各字段如下:
参数 | 类型 | 说明 |
---|---|---|
code | string | 结果码(具体见SDK&API错误码查询) |
data | float | 得分,值为 0~1,值越大表示是同一个人的可能性越大 |
desc | string | 描述 |
sid | string | 会话ID |
其中 sid 字段主要用于追查问题,如果出现问题,可以提供 sid 给讯飞技术人员帮助确认问题。
data中得分阈值与错误率对应关系:
阈值 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 |
---|---|---|---|---|---|---|
错误率 | 十分之一 | 百分之一 | 千分之一 | 万分之一 | 十万分之一 | 百万分之一 |
建议阈值:0.7~0.8
示例如下:
失败:
{
"code": "10107",
"data": 0,
"desc": "body is null",
"sid": "wsr000f071......"
}
成功:
{
"code": "0",
"data": 0.836232,
"desc": "success",
"sid": "wsr000f070......"
}
答:对上传的水印照和人脸照片进行比对,来判断是否为同一个人。
答:(1)水印照支持JPG/BMP/PNG/TIFF,人脸照还支持GIF; (2)宽必须大于8px,人脸照高度小于等于4000px,人脸水印照高度小于等于480px; (3)人脸照大小不超过5M,水印照大小不超过1M。
答:支持Web api应用平台。
答:可以的,登录讯飞开放平台,进入人脸水印照比对页面,点击“服务管理”,创建应用,可免费使用500次,授权期限为1个月。
答:控制台对应人脸水印照比对服务--->实时用量--->点击购买服务量,填好相关信息,商务工作人员会及时与您联系。