BuildFace

Trains HPE 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 HPE 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 HPE 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>

_HP_HTML5_bannerTitle.htm