/face/v2/verify

• 1.接口描述
• 2.请求参数
• 3.返回参数
• 4.错误码
• 5.输入示例

1.接口描述

该API的功能是将两张人脸图片进行比对，来判断是否为同一个人。

• 图片要求
  1. 格式为 JPG（JPEG），BMP，PNG，GIF，TIFF
  2. 宽和高大于 128px，小于等于4000px
  3. 小于等于 5 MB

请求方式：

POST

请求URL：

http://cloudapi.deepfinch.com/face/v2/verify

调试工具

Debugging Tool

2.请求参数

2.1 请求头域

2.2 请求体

注释：

请求参数 file_1 , url_1 与 image_id_1 三选一。

请求参数 file_2,url_2 与 image_id_2 三选一。

参数 file_1 与 file_2 需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

正常响应 （200）

注：

当图片中存在多个人脸时，系统会选出其中最大的人脸进行比对。
identical 字段是在默认阈值0.8时的人脸比对结果，相似度得分score高于默认阈值会返回true。如果希望使用自定义阈值，请将score字段与自定义阈值进行比较获得比对结果。

输出示例：

{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "identical": true,
  "score": 0.928513,
  "image_id_1": "xxxxx",
  "image_id_2": "xxxxx"
}

4.错误码

输出示例：

{
  "status": "DETECTION_FAILED",
  "reason": "no face detected",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例