/recognition/verify

Description

Given a face and a person, decide whether the face belongs to the same person or not. Decision confidence is also provided. Note that the person must have been trained (see also/train/verify).

Parameter

Name Description
Required api_key Your registered API Key
api_secret Your registered API Secret
face_id The id of the face.
person_id or person_name The id or name of the person
Optional async If set to true, the API would be invoked asynchronously (i.e. a session id would be returned immediately, which could be later used to retrieve the result via /info/get_session). Defaults to false.

Return Values

Field Type Description
is_same_person boolean Decision of whether two Face/Person come from the same person in real life and corresponding confidence.
session_id string Unique id of a session

Parameter

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

JSON Response

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

Error Code List

Error Code HTTP Status Code Error Message
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
Google+