In

Method can be used to detect, group and optionally recognize one or more user faces in one or more photos. faces/group method tries to match all the faces that were found in the images specified by urls or through POST one to other, then assigns a group ID for all detected faces that appear to be of the same person. If user ids are specified when calling this methods, method also attempts to assign the most likely user id for each detected face/group of faces. Returned result are similar to faces/recognize method results.

Api call usage is limited. Each passed image (either URL or through POST) is added to your allowed usage.

Note: returned tags can be used to train new users (using tags/save), without the need of additional call to faces/detect).

Method entry point:

https://api.skybiometry.com/fc/faces/group

Supported HTTP methods
GET, POST.
Required parameters
  • uids – a comma separated list of user ids to search for.
  • urls – a comma separated list of images (accepted image formats: PNG, JPEG, BMP, JPEG2000).
Optional parameters
  • namespace – default data namespace to be used for all specified uids without data namespace specified.
  • detector – face detection quality attribute. Normal (default) – fast face and attribute detection, aggressive – more accurate and slower face and attribute detection.
  • attributes – specifies which attributes will be returned with the results. Accepted values: all, none or a comma separated list of supported attributes.
  • threshold – specifies threshold used for tags comparison (minimal confidence value) and splitting faces to groups as a percentage from 0 to 100. Default value is 70.
  • limit – specifies maximum number of matches that will be returned with the results. If not specified value of 100 will be used.
  • return_similarities – specifies whether for each returned tag similarity with all other tags scores will be returned with the results. Zero scores will be skipped.
  • detect_all_feature_points – specifies that all possible feature points are detected if set to true.

Note: in case where you want to POST images instead of specifying urls, request to the method must be formed as a MIME multi-part message sent using POST data. Each argument should be specified as a separate chunk of form data.

Note: in order to minimize query size and in cases you want to use all trained user ids in the database, you can use ‘all@namespace’ keyword as uidsparameter value.

example:

https://api.skybiometry.com/fc/faces/group.json?api_key=aa754b54b37&api_secret=4b3a4c6d4c&urls=https://tinyurl.com/673cksa,https://tinyurl.com/673cksr

response:

{
"groups" : [
{
"tids" : [
"c24ac564_f0bf798c4c4e8",
"TEMP_F@0335b683720f6fcd33b9f432caaf611e_8173f0cbb51b5_46.12_42.06_0_1"
] }
],
"photos" : [
{
"url" : "https://tinyurl.com/673cksr",
"pid" : "F@053a763a06d9d578430b9f2d06c686bb_f0bf798c4c4e8",
"width" : 1024,
"height" : 767,
"tags" : [
{
"tid" : "c24ac564_f0bf798c4c4e8",
"recognizable" : true,
"uids" : [
{
"uid" : "mary@pavelsm",
"confidence" : 98
}
],
"threshold" : 50,
"label" : "",
"confirmed" : true,
"manual" : false,
"width" : 27.73,
"height" : 37.03,
"center" : { "x" : 64.75, "y" : 48.24 },
"eye_left" : { "x" : 66.5, "y" : 39.24 },
"eye_right" : { "x" : 53.12, "y" : 34.55 },
"yaw" : 45,
"roll" : 15,
"pitch" : 0,
"attributes" : {
"face" : { "value" : "true", "confidence" : 71 }
},
"similarities" : [
{
"tid" : "TEMP_F@0335b683720f6fcd33b9f432caaf611e_8173f0cbb51b5_46.12_42.06_0_1",
"similarity" : 90
}
] }
] },
{
"url" : "http://tinyurl.com/673cksa",
"pid" : "F@0335b683720f6fcd33b9f4326a4fd717_8173f0cbb51b5",
"width" : 800,
"height" : 1001,
"tags" : [
{
"tid" : "TEMP_F@0335b683720f6fcd33b9f432caaf611e_8173f0cbb51b5_46.12_42.06_0_1",
"recognizable" : true,
"uids" : [],
"label" : "",
"confirmed" : false,
"manual" : false,
"width" : 25.62,
"height" : 20.48,
"center" : { "x" :46.12, "y" : 42.06 },
"eye_left" : {"x" : 46.25, "y" : 36.96 },
"eye_right" : { "x" : 33.5, "y" : 36.76},
"yaw" : 45,
"roll" : 1,
"pitch" : 0,
"attributes" : {
"face" : { "value" : "true", "confidence" : 72 }
},
"similarities" : [
{
"tid" : "c24ac564_f0bf798c4c4e8",
"similarity" : 90
}
] }
] }
],
"status" : "success",
"usage" : {
"used" : 2,
"remaining" : 98,
"limit" : 100,
"reset_time_text" : "Thu, 27 September 2012 08:54:38 +0000",
"reset_time":1348736078
}
}

Recent Posts