Last 7 days, UTC

Average Latency
132ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Query Authentication
 

Authentication is performed via SkyBiometry account.


Authentication
Description
Parameter
String

This key is generated automatically when creating application in SkyBiometry account page. Register at https://www.skybiometry.com/Account/Register to get one.

api_key

Required

String

This key is also generated automatically when creating application in SkyBiometry account page. Register at https://www.skybiometry.com/Account/Register to get one.

api_secret

Required

Endpoints

HTTP 200 : FCResult POST/account/authenticate
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Account/Authenticate

Returns authentication status. Method can be used to test connection and/or authentication to the API access point. It is not required to call this method before calling any other API methods.


HTTP 200 : FCResult POST/account/limits
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Account/Limits

Returns authentication status. Method can be used to test connection and/or authentication to the API access point. It is not required to call this method before calling any other API methods.


HTTP 200 : FCResult POST/account/namespaces
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Account/Namespaces

Returns all valid data namespaces for user authorized by specified api_key.


HTTP 200 : FCResult POST/account/users
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Account/Users

Returns tags that were registered in the specified user data namespace. Tags are added to namespaces by calling tags/save method.


Test console
Description
Parameter
string

A comma separated list of one or more data namespaces.
Example: MyNamespace

namespaces

Required

HTTP 200 : FCResult POST/faces/detect
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Faces/Detect

Returns tags for detected faces in one or more photos, with geometric information of the tag, eyes, nose and mouth, as well as additional attributes such as gender.


Test console
Description
Parameter
string

A comma separated list of images. Accepted image formats: PNG, JPEG, BMP, JPEG2000.
Example: http://tinyurl.com/673cksr

urls

Optional

string

Face detection quality attribute. Normal (default) – fast face and attribute detection, Aggressive – more accurate and slower face and attribute detection.
Example: Aggressive

detector

Optional

string

Specifies which attributes will be returned with the results. Accepted values: all, none or a comma separated list of supported attributes (currently supported attributes are gender, glasses and smiling, with more to be added in the future). face attribute is the default and is always returned regardless of the specified attributes. dark_glasses attribute is returned additionally when glasses is requested to differentiate between dark and clear glasses.
Example: all

attributes

Optional

binary

A set of binary image files. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

files

Optional

HTTP 200 : FCResult POST/faces/group
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Faces/Group

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.


Test console
Description
Parameter
string

A comma separated list of user ids to search for.
Example: all

uids

Required

string

A comma separated list of images. Accepted image formats: PNG, JPEG, BMP, JPEG2000.
Example: http://tinyurl.com/673cksr

urls

Optional

string

Default data namespace to be used for all specified uids without data namespace specified.
Example: MyNamespace

namespace

Optional

string

Face detection quality attribute. Normal (default) – fast face and attribute detection, Aggressive – more accurate and slower face and attribute detection.
Example: Aggressive

detector

Optional

string

Specifies which attributes will be returned with the results. Accepted values: all, none or a comma separated list of supported attributes (currently supported attributes are gender, glasses and smiling, with more to be added in the future). face attribute is the default and is always returned regardless of the specified attributes. dark_glasses attribute is returned additionally when glasses is requested to differentiate between dark and clear glasses.
Example: all

attributes

Optional

binary

A set of binary image files. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

files

Optional

number

Specifies threshold used for tags comparison (minimal confidence value) and splitting faces to groups as a percentage from 0 to 100. Default value is 60.
Example: 30

threshold

Optional

HTTP 200 : FCResult POST/faces/recognize
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Faces/Recognize

Method is used for recognizing trained user ids in one or more photos. For each detected face, method will return user ids that match specified face or empty result set if no matches found. Each tag also includes a threshold score, if matching score is below this threshold - matched user id can be treated as unlikely match.


Test console
Description
Parameter
string

A comma separated list of user ids to search for.
Example: all

uids

Required

string

A comma separated list of images. Accepted image formats: PNG, JPEG, BMP, JPEG2000.
Example: http://tinyurl.com/673cksr

urls

Optional

string

Default data namespace to be used for all specified uids without data namespace specified.
Example: MyNamespace

namespace

Optional

string

Face detection quality attribute. Normal (default) – fast face and attribute detection, Aggressive – more accurate and slower face and attribute detection.
Example: Aggressive

detector

Optional

string

Specifies which attributes will be returned with the results. Accepted values: all, none or a comma separated list of supported attributes (currently supported attributes are gender, glasses and smiling, with more to be added in the future). face attribute is the default and is always returned regardless of the specified attributes. dark_glasses attribute is returned additionally when glasses is requested to differentiate between dark and clear glasses.
Example: all

attributes

Optional

binary

A set of binary image files. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

files

Optional

number

Maximum number of results in candidates list.
Example: 64

limit

Optional

HTTP 200 : string POST/faces/status
Faces/Status

Method can be used to get training status for specified user ids.


Test console
Description
Parameter
string

A comma separated list of user ids to get training information for.
Example: all

uids

Required

string

Default data namespace to be used for all specified uids without data namespace specified.
Example: MyNamespace

namespace

Optional

HTTP 200 : FCResult POST/faces/train
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Faces/Train

Test console
Description
Parameter
string

comma separated list of user ids to begin training for.
Example: all

uids

Required

string

Default data namespace to be used for all specified uids without data namespace specified.
Example: MyNamespace

namespace

Optional

HTTP 200 : FCResult POST/tags/add
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Tags/Add

Allows to add face tags manually.


Test console
Description
Parameter
string

Url to the image to add the tag to. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

url

Optional

number

Horizontal center position of the tag, as a percentage from 0 to 100, from the left of the photo.

x

Required

number

Vertical center position of the tag, as a percentage from 0 to 100, from the left of the photo.

y

Required

number

Width of the tag, as a percentage from 0 to 100.

width

Required

number

Height of the tag, as a percentage from 0 to 100.

height

Required

string

Id of the user being tagged.

uid

Required

string

Display name of the user being tagged (e.g. First and Last name).

label

Optional

string

Adding of the tag can be password protected if you want to make tags.add a administrative operation. You can specify password in account settings.

password

Optional

HTTP 200 : FCResult POST/tags/get
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Tags/Get

Allows to get already saved tags to data namespace. By specifying different parameters and criteria you can influence the returned tags.


Test console
Description
Parameter
string

A comma separated list of user ids to get tags for.
Example: somebody@MyNamespace

uids

Optional

string

A comma separated list of photo ids to get tags for (photo ids are returned for faces/detect and faces/recognize).

pids

Optional

string

A comma separated list of images to get tags for. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

urls

Optional

string

Maximum tags to return. Default: 5.

limit

Optional

string

When multiple uids are provided, return only tags for photos where all uids appear together in the photo(s). Default: false.

together

Optional

string

Specifies the order of returned tags (recent – for latest tags, random – random selected tags). Default: "recent".

order

Optional

string

Default data namespace to be used for all specified uids without data namespace specified.

namespace

Optional

string

Ability to specify facial attributes for filtering the returned tags.

filter

Optional

binary

A set of binary image files. Accepted image formats: PNG, JPEG, BMP, JPEG2000.

files

Optional

HTTP 200 : FCResult POST/tags/remove
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Tags/Remove

Removes a previously saved tag using tags/save.


Test console
Description
Parameter
string

One or more tag ids to remove. Tag id is a reference field in the response of faces/detect, faces/recognize and tags/get methods.

tids

Required

string

Removing of the tag can be password protected if you want to make tags.remove a administrative operation. You can specify password in account settings.

password

Optional

HTTP 200 : FCResult POST/tags/save
Result of client method call.
						{
    "photos": [
        {
            "url": "http://tinyurl.com/673cksr",
            "pid": "F@0c95576847e9cd7123f1e304476b59ae_59ec9bb2ad15f",
            "width": 375,
            "height": 409,
            "tags": [
                {
                    "tid": "TEMP_F@0c95576847e9cd7123f1e304887741e1_59ec9bb2ad15f_56.80_41.08_0_1",
                    "recognizable": true,
                    "uids": [
                        {
                            "uid": "person0@MyNamespace",
                            "confidence": 18
                        },
                        {
                            "uid": "person1@MyNamespace",
                            "confidence": 16
                        },
                    ],
                    "confirmed": false,
                    "manual": false,
                    "width": 30.4,
                    "height": 27.87,
                    "center": {
                        "x": 56.8,
                        "y": 41.08
                    },
                    "eye_left": {
                        "x": 66.67,
                        "y": 34.47
                    },
                    "eye_right": {
                        "x": 50.67,
                        "y": 34.96
                    },
                    "mouth_center": {
                        "x": 61.07,
                        "y": 50.86
                    },
                    "nose": {
                        "x": 62.13,
                        "y": 42.3
                    },
                    "yaw": -16,
                    "roll": 0,
                    "pitch": 0,
                    "attributes": {
                        "face": {
                            "value": "true",
                            "confidence": 83
                        },
                        "gender": {
                            "value": "female",
                            "confidence": 18
                        }
                    }
                }
            ]
        }
    ],
    "status": "success",
    "usage": {
        "used": 1,
        "remaining": 9999,
        "limit": 10000,
        "reset_time_text": "Tue, 6 November 2012 22:30:53 +0000",
        "reset_time": 1352241053
    }
}						
Tags/Save

Saves a specified face tag to permanent storage. Once the face tag has been saved, you can call faces/train method, which will use the saved tag information to create face template for specified user id and will add it to specified data namespace. When completed you can start recognizing the specified user id (using faces/recognize method).


Test console
Description
Parameter
string

Id of the user being tagged (e.g. mark@docs, where mark – is the name of your choice and docs is the name of created data namespace).

uid

Required

string

One or more comma separated tag ids to associate with the specified uid. Tag id is a reference field in the response of faces/detect and faces/recognize methods.

tids

Required

string

Display name of the user being tagged (e.g. First and Last name).

label

Optional

string

Saving of the tag can be password protected if you want to make tags.save a administrative operation. You can specify password in account settings.

password

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using SkyBiometry Face Detection and Recognition API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.