BuildFace
Trains Media Server to recognize a face.
You can only run this action after creating a face (using the action NewFace) and adding suitable images (using the action AddFaceImages).
Type: asynchronous
Parameter | Description | Required |
---|---|---|
database
|
The name of the database that contains the face. | Yes |
identifier
|
The identifier of the face that you want to train Media Server to recognize. | Yes |
numparallel
|
The maximum number of threads to use to complete the training (default 1), subject to the limit specified by MaxNumParallel. |
No |
Example
/action=BuildFace&database=politicians&identifier=JohnSmith
Response
This action is asynchronous, so Media Server always returns success accompanied by a token. You can use this token with the QueueInfo action to retrieve the status of your request.
<autnresponse> <action>QUEUEINFO</action> <response>SUCCESS</response> <responsedata> <actions> <action> <status>Finished</status> <queued_time>2015-Apr-17 12:51:00</queued_time> <time_in_queue>0</time_in_queue> <process_start_time>2015-Apr-17 12:51:00</process_start_time> <time_processing>1</time_processing> <process_end_time>2015-Apr-17 12:51:01</process_end_time> <database>politicians</database> <identifier>JohnSmith</identifier> <numImages>3</numImages> <numTrained>3</numTrained> <token>...</token> <build> <image> <index>1</index> <label>image1</label> <status>trained</status> </image> <image> <index>2</index> <label>image2</label> <status>trained</status> </image> <image> <index>3</index> <label>image3</label> <status>trained</status> </image> </build> </action> </actions> </responsedata> </autnresponse>