/recognition/compare

描述

计算两个Face的相似性以及五官相似度

参数

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

返回值说明

字段 类型 说明
component_similarity object 包含人脸中各个部位的相似性,目前包含eyebrow(眉毛)、eye(眼睛)、nose(鼻子)与mouth(嘴)的相似性。每一项的值为一个0~100之间的实数,表示相应部位的相似性
similarity float 一个0~100之间的实数,表示两个face的相似性

调用示例

https://apicn.faceplusplus.com/v2/recognition/compare?api_secret=YOUR_API_SECRET&api_key=YOUR_API_KEY&face_id2=b864da69abc1bcf50e5e1a0ea8228077&face_id1=f31f90f78c11d5ba26f67e1302a3014d

JSON 示例

{
    "component_similarity": {
        "eye": 73.679835, 
        "mouth": 77.390801, 
        "nose": 80.22716, 
        "eyebrow": 74.043414
    }, 
    "session_id": "822e13ce5ae9896dbb18f0141d3fd254", 
    "similarity": 74.905818
}

错误列表

错误代码 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