Media Server 25.4
Media Server Help

# BuildVehicleModel

Trains Media Server to recognize a vehicle model.

You can only run this action after creating a vehicle model (using the action NewVehicleModel), and adding suitable images (using the action AddVehicleModelImages). For a step-by-step guide that demonstrates how to train vehicle model recognition, see Train Vehicle Model Recognition.

Type: asynchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database that contains the vehicle model. | 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 `CPU`, to disable GPU acceleration for this action and use the CPU instead. | No
`identifier` | The identifier of the model 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=BuildVehicleModel&database=Cars&identifier=LanciaStratos

## 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>2016-Sep-15 18:13:07</queued_time>
            <time_in_queue>1</time_in_queue>
            <process_start_time>2016-Sep-15 18:13:08</process_start_time>
            <time_processing>0</time_processing>
            <process_end_time>2016-Sep-15 18:13:08</process_end_time>
            <build>
              <image>
                <index>1</index>
                <label>image1</label>
                <status>trained</status>
                <hasimagedata>true</hasimagedata>
                <vehicle>
                  <plate>
                    <readregion>
                      <point>
                        <x>274</x>
                        <y>282</y>
                      </point>
                      <point>
                        <x>367</x>
                        <y>282</y>
                      </point>
                      <point>
                        <x>367</x>
                        <y>297</y>
                      </point>
                      <point>
                        <x>274</x>
                        <y>297</y>
                      </point>
                    </readregion>
                    <plateregion>
                      <point>
                        <x>273</x>
                        <y>280</y>
                      </point>
                      <point>
                        <x>370</x>
                        <y>280</y>
                      </point>
                      <point>
                        <x>370</x>
                        <y>299</y>
                      </point>
                      <point>
                        <x>272</x>
                        <y>299</y>
                      </point>
                    </plateregion>
                    <plateread>...</plateread>
                    <platetype>Regular</platetype>
                    <country>DE</country>
                  </plate>
                  <grillepatch>
                    <point>
                      <x>179</x>
                      <y>200</y>
                    </point>
                    <point>
                      <x>463</x>
                      <y>200</y>
                    </point>
                    <point>
                      <x>463</x>
                      <y>282</y>
                    </point>
                    <point>
                      <x>179</x>
                      <y>282</y>
                    </point>
                  </grillepatch>
                  <grillepercentage>100</grillepercentage>
                </vehicle>
              </image>
            </build>
            <database>Cars</database>
            <identifier>LanciaStratos</identifier>
            <numimages>1</numimages>
            <numtrained>1</numtrained>
            <token>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</token>
          </action>
        </actions>
      </responsedata>
    </autnresponse>

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

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 MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: BuildVehicleModel