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 that the action can use (default 1). | No |
Example
/action=BuildFace&database=politicians&identifier=JohnSmith
Response
This action is asynchronous, so Media Server always returns success accompanied by a token:
<autnresponse> <action>BUILDFACE</action> <response>SUCCESS</response> <responsedata> <token>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</token> </responsedata> </autnresponse>
You can use this token with the QueueInfo action to retrieve the status of the action:
<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>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</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>