FaceR^TMAPI

Function Reference

Detect

Finds either face information (a bounding box around faces), face + eye information including eye centers and possibly eye corners (eye corners should not be relied on to be present in every response), or full feature information including eyebrows, eye corners, nose, chin, lips, and ears for each face. If selecting full or setpose, the gender and confidence level will be returned for all faces found in the image. Intended for faster detection and pre-processing of images. The output face or eye coordinates of this function may be modified and sent to Detect Features. Coordinates all begin at the top left of the image. The image_id returned by this function is a reference to a temporarily cached image that can be passed to Detect Features, Enroll, or Find operations.

All binary images supplied to this function are stored for later use by Enroll and Find operations. Images are deleted after 5 hours.

Method	`POST`
URL	`http://api_url/v2/detect`
Response	`json`
Request Parameters
`api_key`
`selector`	[ FACE \| EYES \| FULL \| SETPOSE ] - return information on all faces in the image (default "FACE"), all faces + eyes ("EYES"), all faces + eyes + features ("FULL"), or all faces + eyes + features + setpose ("SETPOSE") for all faces (see sample response below), attributes such as gender will also be returned for all requests except for the FACE selector
`minHeadScale`	(optional) ratio of smallest considered head size to the shortest image dimension. Value must be a float > 0.015 (1:64) and <= 0.5 (1:2), default 0.125 (1:8)
`url`	image url containing possible face or faces for detection
`image`	(optional, required if url omitted) jpg or png multipart image stream containing at least one face
`symmetricFill`	(optional if selector == SETPOSE) fills occluded facets, (true \| false, default false)
`setPitch`	(optional if selector == SETPOSE) set the pitch (up/down) output for the SetPose rendering, (range -90 to 90, default 0)
`setYaw`	(optional if selector == SETPOSE) set the yaw (left/right) output for the SetPose rendering, (range -90 to 90, default 0)
`setRoll`	(optional if selector == SETPOSE) set the roll (tilt) output for the SetPose rendering, (range -90 to 90, default 0)

Detect Features

Finds either eye information, full feature information, or full features + "Setpose" for one face in a picture. Face bounding box or eye center coordinates must be supplied, and may be taken from the output of basic Detect. "Setpose" is a returned image which contains a frontal view of a face which has been zero-corrected for pitch, yaw, and roll (like a mug shot). Intended for more detailed detection than basic Detect. Since this function takes the face bounding box or eye coordinates, corrections may be made on the values output from Detect. The image_id returned by this function is a reference to a temporarily cached image that can be passed back to other Detect Features calls, or Enroll or Find calls.

Setpose images are returned as URLs which are made private through obfuscation. Setpose image urls expire after 20 minutes.

All binary images supplied to this function are stored for later use by Enroll and Find operations. Images are deleted after 5 hours.

Method	`POST`
URL	`http://api_url/v2/detect_features`
Response	`json`
Request Parameters
`api_key`
`topLeftX`	X-Coordinate for top left corner of face. May be modified from basic Detect output.
`topLeftY`	Y-Coordinate for top left corner of face. May be modified from basic Detect output.
`width`	Width of face. May be modified from basic Detect output.
`height`	Height of face. May be modified from basic Detect output.
`leftEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the left eye center. May be modified from basic Detect output.
`leftEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the left eye center. May be modified from basic Detect output.
`rightEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the right eye center. May be modified from basic Detect output.
`rightEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the right eye center. May be modified from basic Detect output.
`selector`	[ EYES \| FULL \| SETPOSE ] - return information on one face + eyes in the image (default "EYES"), full features ("FULL") for one face, or full features + set pose ("SETPOSE")
`url`	image url containing possible face or faces for detection
`image`	(optional, required if url and image_id omitted) jpg or png multipart image stream containing one face of this person
`image_id`	(optional, required if url and image omitted) an image ID that was returned from a basic detect operation
`symmetricFill`	(optional if selector == SETPOSE) fills occluded facets, (true \| false, default false)
`setPitch`	(optional if selector == SETPOSE) set the pitch (up/down) output for the SetPose rendering, (range -90 to 90, default 0)
`setYaw`	(optional if selector == SETPOSE) set the yaw (left/right) output for the SetPose rendering, (range -90 to 90, default 0)
`setRoll`	(optional if selector == SETPOSE) set the roll (tilt) output for the SetPose rendering, (range -90 to 90, default 0)

Detect - Sample Code

# image url:
curl -F "api_key=YOUR_API_KEY" -F "url=http://example.com/example.jpg" http://23.21.173.192/v2/detect
# image file:
curl -F "api_key=YOUR_API_KEY" -F "image=@/path/to/local/file" http://23.21.173.192/v2/detect

try
{
	//if using mashape, add custom headers and use the mashape server ip address.
	$mashape_key ='YOUR_MASHAPE_KEY_HERE';
	$headers = array('X-Mashape-Key: ' . $mashape_key);
	$server_ip = 'https://animetrics.p.mashape.com/v2/detect';
	//else
	$headers = array();
	$server_ip = 'http://23.21.173.192/v2/detect';
	$animetrics_api_key ='YOUR_API_KEY_HERE';
	$path_to_local_file = '/Users/someone/image.jpg';
	$data = array('api_key'=>$animetrics_api_key,'image'=>'@'.$path_to_local_file);
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $server_ip);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	$response = curl_exec($ch);
	//echo $response;
	$json = json_decode($response);
	if (empty($json) || sizeof($json->images) < 1 || sizeof($json->images[0]->faces) < 1)
		throw new Exception('No faces found in response!');
	$image_id = $json->images[0]->image_id;
	// {...} store $image_id locally
	$topLeftX = $json->images[0]->faces[0]->topLeftX;
	$topLeftY = $json->images[0]->faces[0]->topLeftY;
	$width    = $json->images[0]->faces[0]->width;
	$height   = $json->images[0]->faces[0]->height;
	echo "Face found with imageid $image_id at ($topLeftX, $topLeftY, $width, $height)" . PHP_EOL;
}
catch(Exception $e)
{
	echo $e->getMessage() . PHP_EOL;
}

#gem install rest-client
require 'rest_client'
require 'json'
response = RestClient.post 'http://23.21.173.192/v2/detect',
  { :api_key => animetrics_api_key,
    :image => File.new(path_to_local_file) }
json = JSON.parse response
unless json['images'].length < 1 or json['images'][0]['faces'].length < 1
  image_id = json['images'][0]['image_id']
  # {...} store image_id locally
  top_left_x = json['images'][0]['faces'][0]['topLeftX']
  top_left_y = json['images'][0]['faces'][0]['topLeftY']
  width      = json['images'][0]['faces'][0]['width']
  height     = json['images'][0]['faces'][0]['height']
end

// requires Apache HTTP Components: http://hc.apache.org/
// requires Apache Commons Logging: http://commons.apache.org/proper/commons-logging/index.html

HttpPost post = new HttpPost("http://23.21.173.192/v2/detect");
File file = new File(pathToLocalFile);
RandomAccessFile f = new RandomAccessFile(file, "r");
byte[] data = new byte[(int)f.length()];
f.read(data);
ByteArrayBody body = new ByteArrayBody(data, file.getName());
StringBody apiKeyBody = new StringBody(animetricsApiKey);
MultipartEntity entity = new MultipartEntity();
entity.addPart("image", body);
entity.addPart("api_key", apiKeyBody);
post.setEntity(entity);
HttpClient client = new DefaultHttpClient();
HttpResponse response = null;
try {
  response = client.execute(post);
} catch (ClientProtocolException e) {
  e.printStackTrace();
} catch (IOException e) {
  e.printStackTrace();
}
if (response != null) {
  String responseStr = (EntityUtils.toString(response.getEntity()));
  Object obj = JSONValue.parse(responseStr);
  JSONObject jsonObj = (JSONObject) obj;
  JSONArray images = (JSONArray) jsonObj.get("images");
  jsonObj = (JSONObject) images.get(0);
  String imageId = (String) jsonObj.get("image_id");
  // {...} store imageId locally
  JSONArray faces = (JSONArray) jsonObj.get("faces");
  jsonObj = (JSONObject) faces.get(0);
  Long topLeftX = (Long) jsonObj.get("topLeftX");
  Long topLeftY = (Long) jsonObj.get("topLeftY");
  Long width    = (Long) jsonObj.get("width");
  Long height   = (Long) jsonObj.get("height");
}

Detect - Sample Response

{
    "images": [
        {
            "time": 2.67475,
            "status": "Complete",
            "file": "http://example.com/some_image.jpg",
            "width": 379,
            "height": 270,
            "image_id":"7245253dbd2a142ceb40e031cb173734",
            "image_expiration":"2013-01-11 18:36 -0500",
            "setpose_image": "http://23.21.173.192/img/setpose/67640462509aeda5d23841.24750584.jpg",
            "faces": [
                {
                    "topLeftX": 273,
                    "topLeftY": 95,
                    "width": 45,
                    "height": 45,
                    "leftEyeCenterX": 283.877,
                    "leftEyeCenterY": 107.796,
                    "rightEyeCenterX": 302.113,
                    "rightEyeCenterY": 101.085,
                    "noseTipX": 289.074,
                    "noseTipY": 121.905,
                    "noseBtwEyesX": 289.048,
                    "noseBtwEyesY": 102.884,
                    "chinTipX": -1,
                    "chinTipY": -1,
                    "leftEyeCornerLeftX": 280.847,
                    "leftEyeCornerLeftY": 109.235,
                    "leftEyeCornerRightX": 288.466,
                    "leftEyeCornerRightY": 107.078,
                    "rightEyeCornerLeftX": 298.259,
                    "rightEyeCornerLeftY": 103.798,
                    "rightEyeCornerRightX": 305.458,
                    "rightEyeCornerRightY": 100.501,
                    "rightEarTragusX": -1,
                    "rightEarTragusY": -1,
                    "leftEarTragusX": -1,
                    "leftEarTragusY": -1,
                    "leftEyeBrowLeftX": 277.839,
                    "leftEyeBrowLeftY": 104.823,
                    "leftEyeBrowMiddleX": 280.527,
                    "leftEyeBrowMiddleY": 102.526,
                    "leftEyeBrowRightX": 286.043,
                    "leftEyeBrowRightY": 101.751,
                    "rightEyeBrowLeftX": 293.964,
                    "rightEyeBrowLeftY": 98.7854,
                    "rightEyeBrowMiddleX": 300.753,
                    "rightEyeBrowMiddleY": 96.2432,
                    "rightEyeBrowRightX": 308.567,
                    "rightEyeBrowRightY": 95.5753,
                    "nostrilLeftHoleBottomX": 291.582,
                    "nostrilLeftHoleBottomY": 125.159,
                    "nostrilRightHoleBottomX": 296.78,
                    "nostrilRightHoleBottomY": 123.535,
                    "nostrilLeftSideX": 289.109,
                    "nostrilLeftSideY": 122.86,
                    "nostrilRightSideX": 299.787,
                    "nostrilRightSideY": 119.506,
                    "lipCornerLeftX": 290.411,
                    "lipCornerLeftY": 134.952,
                    "lipLineMiddleX": 297.871,
                    "lipLineMiddleY": 135.062,
                    "lipCornerRightX": 306.817,
                    "lipCornerRightY": 131.389,
                    "pitch": 7.44029,
                    "yaw": 44.8204,
                    "roll": -17.9817
                },
                {
                    "topLeftX": 116,
                    "topLeftY": 136,
                    "width": 42,
                    "height": 42,
                    "leftEyeCenterX": 123.668,
                    "leftEyeCenterY": 147.12,
                    "rightEyeCenterX": 144.391,
                    "rightEyeCenterY": 141.291,
                    "noseTipX": 128.745,
                    "noseTipY": 155.872,
                    "noseBtwEyesX": 130.924,
                    "noseBtwEyesY": 143.534,
                    "chinTipX": 135.509,
                    "chinTipY": 180.942,
                    "leftEyeCornerLeftX": 119.55,
                    "leftEyeCornerLeftY": 148.627,
                    "leftEyeCornerRightX": 128.292,
                    "leftEyeCornerRightY": 146.168,
                    "rightEyeCornerLeftX": 139.392,
                    "rightEyeCornerLeftY": 143.395,
                    "rightEyeCornerRightX": 148.134,
                    "rightEyeCornerRightY": 140.936,
                    "rightEarTragusX": -1,
                    "rightEarTragusY": -1,
                    "leftEarTragusX": -1,
                    "leftEarTragusY": -1,
                    "leftEyeBrowLeftX": 116.046,
                    "leftEyeBrowLeftY": 144.918,
                    "leftEyeBrowMiddleX": 119.101,
                    "leftEyeBrowMiddleY": 141.92,
                    "leftEyeBrowRightX": 125.719,
                    "leftEyeBrowRightY": 141.461,
                    "rightEyeBrowLeftX": 135.249,
                    "rightEyeBrowLeftY": 138.755,
                    "rightEyeBrowMiddleX": 142.669,
                    "rightEyeBrowMiddleY": 134.872,
                    "rightEyeBrowRightX": 151.632,
                    "rightEyeBrowRightY": 135.168,
                    "nostrilLeftHoleBottomX": 128.879,
                    "nostrilLeftHoleBottomY": 160.096,
                    "nostrilRightHoleBottomX": 134.795,
                    "nostrilRightHoleBottomY": 158.416,
                    "nostrilLeftSideX": 127.098,
                    "nostrilLeftSideY": 158.826,
                    "nostrilRightSideX": 138.787,
                    "nostrilRightSideY": 156.217,
                    "lipCornerLeftX": 127.548,
                    "lipCornerLeftY": 170.417,
                    "lipLineMiddleX": 133.371,
                    "lipLineMiddleY": 168.409,
                    "lipCornerRightX": 144.495,
                    "lipCornerRightY": 166.315,
                    "pitch": 12.8969,
                    "yaw": 27.5579,
                    "roll": -14.2118
                }
            ]
        }
    ]
}

Enroll

Computes a biometric signature for a known face ("subject") in a picture and adds it to a collection ("gallery") for later searching. The subject id and gallery id must be supplied in addition to an image id reference from a previous Detect or Detect Features call. A subject id must be a globally unique identifier for each known individual identity for each API key. Subjects may exist in more than one gallery and can be added to or removed from a gallery with the Add To Gallery and Remove From Gallery functions. Adding multiple pictures of the same subject will help improve matching accuracy. Similarly, adding pictures of different people with the same subject id will negatively affect the accuracy of the matching algorithm.

Enroll operations also require a face hint describing which face in a picture is to be enrolled. This may be in the form of face bounds (topLeftX, topLeftY, width, height) or eye coordinates (leftEyeCenterX, leftEyeCenterY, rightEyeCenterX, rightEyeCenterY). These landmarks may all be taken from the output of Detect or Detect Features calls.

Method	`GET`
URL	`http://api_url/v2/enroll`
Response	`json`
Request Parameters
`api_key`
`subject_id`	a unique ID describing this person
`gallery_id`	a unique ID indicating the collection to which the person should be enrolled
`image_id`	an image ID that was returned from a detect operation
`topLeftX`	X-Coordinate for top left corner of face. May be modified from Detect output.
`topLeftY`	Y-Coordinate for top left corner of face. May be modified from Detect output.
`width`	Width of face. May be modified from Detect output.
`height`	Height of face. May be modified from Detect output.
`leftEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the left eye center. May be modified from Detect output.
`leftEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the left eye center. May be modified from Detect output.
`rightEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the right eye center. May be modified from Detect output.
`rightEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the right eye center. May be modified from Detect output.

Enroll - Sample Code

curl

# step 1 - detect:
curl -F "api_key=YOUR_API_KEY" -F "url=http://example.com/example.jpg" http://23.21.173.192/v2/detect
# step 2 - enroll with image_id and face coordinates from detect; face coordinates may be modified:
curl "http://23.21.173.192/v2/enroll?api_key=YOUR_API_KEY&subject;_id=John_Doe&gallery;_id=gallery1ℑ_id=IMAGE_ID_FROM_DETECT&topLeftX;=FROM_DETECT&topLeftY;=FROM_DETECT&width;=FROM_DETECT&height;=FROM_DETECT"

Enroll - Sample Response

{
    "images": [
        {
            "time": 4.44877,
            "transaction": {
                  "status": "Complete"
                  "face_id": "8475566e64f078a4dddf006957e66b9c",
                  "image_id": "fa24a7105954c315d4d352824e1a12b4"
                  "subject_id": "Subject1"
                  "gallery_id": "Gallery1"
            }
        }
    ]
}

Recognize

Matches an unknown face against a collection ("gallery") of known faces. Galleries are built using the Enroll function. Response includes a similarity score between 0 and 1 for all closely matching subjects in the gallery.

A gallery id must be supplied in addition to an image id reference from a previous Detect or Detect Features call. Recognize operations require a face hint describing which face in a picture is to be enrolled. This may be in the form of face bounds (topLeftX, topLeftY, width, height) or eye coordinates (leftEyeCenterX, leftEyeCenterY, rightEyeCenterX, rightEyeCenterY). These landmarks may all be taken from the output of Detect or Detect Features calls.

Method	`GET`
URL	`http://api_url/v2/recognize`
Response	`json`
Request Parameters
`api_key`
`gallery_id`	a unique ID indicating the collection which this unknown person should be compared against
`image_id OR face_id`	an image ID that was returned from a detect operation OR a face ID from the response of a previous enrollment
`max_num_results`	the maximum number of matches returned by this search (default 10)
`topLeftX`	X-Coordinate for top left corner of face. May be modified from Detect output.
`topLeftY`	Y-Coordinate for top left corner of face. May be modified from Detect output.
`width`	Width of face. May be modified from Detect output.
`height`	Height of face. May be modified from Detect output.
`leftEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the left eye center. May be modified from Detect output.
`leftEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the left eye center. May be modified from Detect output.
`rightEyeCenterX`	(required if face coordinates/dimensions omitted) X-Coordinate for the right eye center. May be modified from Detect output.
`rightEyeCenterY`	(required if face coordinates/dimensions omitted) Y-Coordinate for the right eye center. May be modified from Detect output.

Recognize - Sample Code

curl

# step 1 - detect:
curl -F "api_key=YOUR_API_KEY" -F "url=http://example.com/example.jpg" http://23.21.173.192/v2/detect
# step 2 - recognize with image_id and face coordinates from detect; face coordinates may be modified:
curl "http://23.21.173.192/v2/recognize?api_key=YOUR_API_KEY&gallery;_id=gallery1ℑ_id=IMAGE_ID_FROM_DETECT&topLeftX;=FROM_DETECT&topLeftY;=FROM_DETECT&width;=FROM_DETECT&height;=FROM_DETECT"

Recognize - Sample Response

{
    "images": [
        {
            "time": 6.15279,
            "transaction": {
                  "status": "Complete"
                  "face_id": "8475566e64f078a4dddf006957e66b9c",
                  "image_id": "fa24a7105954c315d4d352824e1a12b4"
                  "gallery_id": "Gallery1"
            }
            "candidates": {
                  "Subject1": "0.00748587679117918",
                  "Subject2": "0.00298891984857619",
                  "Subject3": "0.0020080110989511",
                  "Subject4": "0.00195363769307733",
                  "Subject5": "0.00115325523074716",
                  "Subject6": "0.00107188778929412"
            }
        }
    ]
}

Verify

Verify if an unknown face (or collection of faces of an unknown individual) has the same identity as a claimed target. A similarity score is returned, and is optimized for discriminating the target subject from other individuals. Note that there must be at least two faces of the target subject enrolled.

Method	`GET`
URL	`http://api_url/v2/verify`
Response	`json`
Request Parameters
`api_key`
`subject_id_of_target`	a unique subject ID of the known person
`subject_id_of_unknown`	a unique subject ID of the person who's identity is to be verified

Verify - Sample Code

curl

# verify subject Sean against Marc
curl "http://23.21.173.192/v2/verify?api_key=YOUR_API_KEY&subject;_id_of_target=Marc&subject;_id_of_unknown=Sean"

Verify - Sample Response

{"time":0.8793,"score":0.0943282}

List Galleries

Lists the galleries that have been created by your personal API key.

Method	`GET`
URL	`http://api_url/v2/list_galleries`
Response	`json`
Request Parameters
`api_key`

List Galleries - Sample Response

{
  "time": 0.00585,
  "status": "Complete",
  "gallery_ids": ["Gallery1","Gallery2","Gallery3"]
}

View Gallery

View the subject ids that have been enrolled in a specific gallery.

Method	`GET`
URL	`http://api_url/v2/view_gallery`
Response	`json`
Request Parameters
`api_key`
`gallery_id`	A unique ID indicating the gallery to query.

View Gallery - Sample Response

{
  "time": 0.00498,
  "status": "Complete",
  "subject_ids": ["Subject1","Subject2","Subject3"]
}

View Subject

View the face ids that have been enrolled in a specific subject.

Method	`GET`
URL	`http://api_url/v2/view_subject`
Response	`json`
Request Parameters
`api_key`
`subject_id`	unique subject ID that matches one or more previous enrollments

View Subject - Sample Response

{
"time": 0.02634,
"status": "Complete",
"face_ids": ["fd51334a89e7588d02f6dc0f215cf52d","6317566a262b4c0adfba18b79b3801c8"]
}

Add To Gallery

Adds an already enrolled Subject into an existing or uncreated Gallery. Galleries that don't exist will automatically be created.

Method	`GET`
URL	`http://api_url/v2/add_to_gallery`
Response	`json`
Request Parameters
`api_key`
`subject_id`	The ID used to previously enroll some person ("subject")
`gallery_id`	A unique ID indicating the collection to which the subject should be added. If this gallery doesn't exist, it will be created.

Add To Gallery - Sample Response

{
  "time":0.01769,
  "status":"Complete"
}

Remove From Gallery

Removes an already enrolled Subject from an existing Gallery. If this is the only subject in that Gallery, the Gallery will be deleted. If the Subject exists in no other Galleries, he will be deleted from the Face Recognition System.

Method	`GET`
URL	`http://api_url/v2/remove_from_gallery`
Response	`json`
Request Parameters
`api_key`
`subject_id`	The ID used to previously enroll some person ("subject")
`gallery_id`	A unique ID indicating the collection from which the subject should be removed. If the subject exists in no other galleries, his biometric template will be removed from the Facial Recognition System and subsequent Add To Gallery operations for this subject will fail.

Remove From Gallery - Sample Response

{
  "time":0.00825,
  "status":"Complete",
  "subject removed":"Subject was removed - not in any remaining galleries.",
  "gallery removed":"Gallery was removed - no remaining subjects."
}

Delete Face

Delete a Face from a known Subject. This operation will only delete the individual Face that is associated with an enrollment transaction for a Subject. The Face ID that is required should be taken from the response of a previous enrollment. Deleteing a Face from a Subject who belongs to more than one gallery will affect that Subject's identity in each gallery.

This operation might be used if several pictures of an individual are enrolled and then later it is found out that one of these pictures was in fact someone else who's identity is unknown.

Method	`GET`
URL	`http://api_url/v2/delete_face`
Response	`json`
Request Parameters
`api_key`
`face_id`	face ID from the response of a previous enrollment

Delete Face - Sample Response

{
  "images": [
      {
        "time":0.43286,
        "status":"Complete",
        "trans_id":"8c1c173787cb4af796dc365d020a19ee"
      }
}

Assign Face to Subject

Assign Face ID to a Subject ID. This operation will change the Subject ID associated with an individual Face ID. The Face ID that is required should be taken from the response of a previous enrollment. Assigning a Face ID to a new Subject ID who belongs to more than one gallery will affect that Subject's identity in each gallery.

This operation might be used if several pictures of an individual are enrolled and then later it is found out that one of these pictures was in fact someone else.

Method	`GET`
URL	`http://api_url/v2/assign_face_to_subject`
Response	`json`
Request Parameters
`api_key`
`face_id`	face ID from the response of a previous enrollment
`subject_id`	unique subject ID to replace that of a previous enrollment

Assign Face to Subject - Sample Response

{
  "time":0.43286,
  "status":"Complete",
  "trans_id":"8c1c173787cb4af796dc365d020a19ee"
}

Usage

Retrieve your current daily and monthly count of function calls made to the api. Total, billable, detect, enroll and recognize counts are displayed.

Method	`GET`
URL	`http://23.21.173.192/v2/usage`
Response	`json`
Request Parameters
`api_key`

Usage - Sample Response

{
  "usage":
  {
    "today":
    {
      "total":613,
      "billable":221,
      "detect":111,
      "enroll":87
      "recognize":23
    },
    "month";
    {
      "total":5238,
      "billable":3068,
      "detect":1698,
      "enroll":1286,
      "recognize":84
    }
}

FaceRTMAPI