/recognition/verify

描述

给定一个Face和一个Person,返回是否是同一个人的判断以及置信度。

注意,当Person中的信息被修改之后(增加,删除了Face等),为了保证结果与最新数据一致,Person应当被重新train。 见/train/verify 。否则调用此API时将使用最后一次train时的数据。

参数

参数名 参数说明
必须 api_key App的Face++ API Key
api_secret APP的Face++ API Secret
face_id 待verify的face_id
person_id 或 person_name 对应的Person
可选 async 如果置为true,该API将会以异步方式被调用;也就是立即返回一个session id,稍后可通过/info/get_session查询结果。默认值为false。

返回值说明

字段 类型 说明
is_same_person boolean 两个输入是否为同一人的判断
confidence float 系统对这个判断的置信度。
session_id string 相应请求的session标识符,可用于结果查询

调用示例

https://apicn.faceplusplus.com/v2/recognition/verify?api_secret=YOUR_API_SECRET&face_id=7fa73e35a15a0521739a5256d25b6e02&api_key=YOUR_API_KEY&person_name=FanBingBing

JSON 示例

{
    "confidence": 55.039787, 
    "is_same_person": true, 
    "session_id": "a58bbfc672abce074111166dd9961163"
}

错误列表

错误代码 HTTP 状态代码 错误信息
1001 500 INTERNAL_ERROR
1003 403 AUTHORIZATION_ERROR
1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED
1004 400 MISSING_ARGUMENTS
1005 400 INVALID_ARGUMENTS
1006 403 ILLEGAL_USE_OF_DEMO_KEY
1202 502 SERVER_TOO_BUSY
1401 441 OBJECT_UNTRAINED