/grouping/grouping

描述

给出一个Faceset,尝试将其分类,使得来自同一个人的Face被放在同一类中。

Grouping所花费的时间较长, 因此该调用是异步的,仅返回session_id。

参数

参数名 参数说明
必须 api_key App的Face++ API Key
api_secret APP的Face++ API Secret
faceset_id 或 faceset_name 相应Faceset的id或name。

返回值说明

字段 类型 说明
session_id string 相应请求的session标识符,可用于结果查询
create_time int 任务开始时间,单位:秒
finish_time int 任务结束时间,单位:秒
face_id string 被检测出的每一张人脸都在Face++系统中的标识符
group array 分类结果,来自不同人的face被归到不同的类中
ungrouped array 未归类face对象,无法被归类的face集合
status string /info/get_session中,相应session的与状态。
取值为 SUCC(已完成) / FAILED(失败) / INQUEUE(队列中)

调用示例

https://apicn.faceplusplus.com/v2/grouping/grouping?api_secret=YOUR_API_SECRET&faceset_id=c0d0e124a8921f4895658c2419dc8909&api_key=YOUR_API_KEY

JSON 示例

{
    "session_id": "39cddae6a2a8da9a29affb2e1a1fb7c1"
}
{
    "create_time": 1364542970, 
    "finish_time": 1364542970, 
    "result": {
        "group": [
            [
                {
                    "face_id": "199d1efd19ce4ee67a7ec7655f859b1a", 
                    "tag": ""
                }, 
                {
                    "face_id": "02ff3c4a65a7a055ddd6ce788a345842", 
                    "tag": ""
                }
            ],
            [
                {
                    "face_id": "614cca6e9ec0d45c2904bd0a30d5343f", 
                    "tag": ""
                }, 
                {
                    "face_id": "15b27925563e0d580e3273262028d04c", 
                    "tag": ""
                }
            ]            
        ], 
        "ungrouped": [
	        {
    	        "face_id": "34238667d64444abfe7b8bf0b454c9ce", 
        	    "tag": ""
	        }
    	]
    }, 
    "session_id": "83b8126d6f644ef69ffe02b69cbe86c5", 
    "status": "SUCC"
}

错误列表

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