Media Server 12.12

# 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>

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Media Server 12.12

Topic Title: BuildFace