Method is used to train specified users. Method uses tags previously saved using tags/save methods and creates face template for the specified user ids.
Once the face tags were trained, specified user id can be recognized using faces/recognize method calls.
Note: currently call to faces/train is a blocking call, which means that the call will return when all the requested tags will be processed. You can asynchronously query the status of the training procedure by calling faces/status method.
Method entry point:
https://api.skybiometry.com/fc/faces/train
- Supported HTTP methods
- GET, POST.
- Required parameters
-
- standard API parameters
- uids – a comma separated list of user ids to begin training for.
- Optional parameters
-
- namespace – default data namespace to be used for all specified uids without data namespace specified.
Note: method result includes specified user id training statuses:
- no_training_set – user ids, for which there is not enough data to create face templates.
- created – user ids, for which new face templates were created.
- updated – user ids, for which face templates were changed/updated.
- unchanged – user ids, for which no changes have been made.
- in_progress – user ids, for which changes are being made (maybe by another training call).
example:
https://api.skybiometry.com/fc/faces/train.json?api_key=aa754b54b37&api_secret=4b3a4c6d4c&uids=mark@docs
response:
{
"status" : "success",
"created" : [
{
"uid" : "mark@docs",
"training_set_size" : 2,
"last_trained" : 1348662115,
"training_in_progress" : false
}
],
"usage" : {
"used" : 1,
"remaining" : 99,
"limit" : 100,
"reset_time_text" : "Fri, 22 September 2012 12:57:19 +0000",
"reset_time" : 1348232239
}
}
