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 |
gpudeviceid
|
The device ID of the GPU to use, if you have enabled GPU acceleration and want to override the value of the GPUDeviceID configuration parameter. You can also set this parameter to |
No |
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>