# AddObjectClassImages

Adds training images to an object class recognizer.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`recognizer` | The name of the recognizer to add the images to. | Yes
`imagedata` | The training images to add. You must upload files as multipart/form-data. For more information about sending data to Media Server, refer to the Media Server Administration Guide. | Set this or `imagepath`.
`imagelabels` | A comma-separated list of labels to identify the images that you are adding (maximum 254 bytes for each label). Every image added to the same recognizer must have a unique label, so the number of labels must match the number of images provided using either `imagedata` or `imagepath`. If you do not set this parameter, Media Server generates labels automatically. | No
`imagepath` | A comma-separated list of paths to the training images to add. The paths must be absolute, or relative to the Media Server executable file. | Set this or `imagedata`.

## Example

The following example adds training images to an object class recognizer by specifying the paths of the images using the `imagepath` parameter:

    curl http://localhost:14000 -F action=AddObjectClassImages
                                -F recognizer=vehicles
                                -F imagepath=image1.jpg,image2.jpg
                                -F imagelabels=image1,image2

Alternatively, you can add training images by sending the image data, for example:

    curl http://localhost:14000 -F action=AddObjectClassImages
                                -F recognizer=vehicles
                                -F imagedata=@image1.jpg,image2.jpg
                                -F imagelabels=image1,image2

## Response

    <autnresponse>
      <action>ADDOBJECTCLASSIMAGES</action>
      <response>SUCCESS</response>
      <responsedata>
        <image>
          <index>1</index>
          <label>image1</label>
        </image>
        <image>
          <index>2</index>
          <label>image2</label>
        </image>
      </responsedata>
    </autnresponse>

## See Also

- The object class recognizer must already exist. To create one, use the action CreateObjectClassRecognizer.
- After adding training images you can annotate them. An annotation identifies a region of a training image that contains an object, and the class that the object belongs to. Media Server can then use that region of the image to train the recognizer. To add annotations, use the action AddObjectClassAnnotations.

_FT_HTML5_bannerTitle.htm