1. 接口说明

对两张通过接口上传的人脸照片进行比对,来判断是否为同一个人

若上传的照片中包含 exif 方向信息,我们会按此信息旋转、翻转后再做后续处理。

同时,我们还提供自动旋转功能,当照片方向混乱且 exif 方向信息不存在或不正确的情况下,服务会根据照片中人脸方向来检查可能正确的方向,并按照正确的方向提供人脸检测结果。

2. 接口地址

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

3. 请求参数

在 Http Request Header 中配置授权认证参数,见【接口描述-授权认证。 其中 X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串,原始 JSON 串各字段说明如下:

参数 类型 必须 说明 示例
auto_rotate bool 是否对图片进行自动旋转,true旋转,false不旋转,默认false true

X-Param生成示例:

原始JSON串:
{
    "auto_rotate": True,
}
BASE64编码(即X-Param):
ewoJICAgICJhdXRvX3JvdGF0ZSI6ICJ0cnVlIiwKCX0=

在 Http Request Body 中配置以下参数:

参数 类型 必须 说明
face_image string 需上传的人脸照,base64编码后与base64编码后的水印照整体进行 urlencode,格式必须为JPG(JPEG),BMP,PNG,GIF,TIFF之一,宽和高必须大于8px,小于等于4000px,要求原始图片大小不超过5M
watermark_image string 需上传的水印照,base64编码后与base64编码后的人脸照整体进行 urlencode,格式必须为JPG(JPEG),BMP,PNG,TIFF之一,宽和高必须大于 8px,小于等于480px,原始文件尺寸小于等于1MB

4. 返回值

返回值为 json 串,各字段如下:

参数 类型 说明
code string 结果码(具体见错误码)
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": "10106",
    "desc": "invalid parameter|invalid X-Appid",
    "data": 0,
    "sid": "iwv0000bb3f@ch3d5c059d83b3477200"
}

成功:

{
"data":0.7,
"code":"0",
"desc":"success",
"sid":"iwv00000001@ch36940e324c59000100"
}

5. 调用示例

人脸水印照比对demo go语言

人脸水印照比对demo php语言

人脸水印照比对demo c#语言

人脸水印照比对demo python3语言

人脸水印照比对demo java语言

Copyright © iflytek.com 2018 all right reserved,powered by Gitbook该文件修订时间: 2019-03-20 06:04:52

results matching ""

    No results matching ""