Motivation

Usually hires material imported into the system can be quite resource demanding to work with. Therefor, creating a proxy version of the material is a good way to save on bandwidth, storage, cpu while working with the material and then let the backend take care of doing the transformation on the original file.

Example

An item can be transcoded either when it is imported or afterwards by using the item transcode resource. The difference between transcoding while and after importing is that the former can be done in parallel to any transfers that may be needed, while the latter is a serial task as the input files, the files from the original shape of the item, should already exist on a storage managed by Vidispine.

In both cases the type of format which we want to transcode to can be specified using the tag parameter.

Example of triggering a transcode to a proxy shape of format __mp4 during import:

POST /import?uri=file:///srv/incoming/media.mov&tag=__mp4

Response:

<JobDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <jobId>VX-169819</jobId>
  <user>admin</user>
  <started>2014-07-03T07:20:14.220Z</started>
  <status>READY</status>
  <type>PLACEHOLDER_IMPORT</type>
  <priority>MEDIUM</priority>
</JobDocument>
CODE

Example of triggering a transcode to a proxy shape of format __mp4 for an item in VidiCore:

POST /item/VX-191440/transcode?tag=__mp4

Response:

<JobDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <jobId>VX-169820</jobId>
  <user>admin</user>
  <started>2014-07-03T07:22:47.900Z</started>
  <status>READY</status>
  <type>TRANSCODE</type>
  <priority>MEDIUM</priority>
</JobDocument>
CODE

As the job has finished, we can ask the API for the shape of our proxy type:

GET /item/VX-191440/shape?tag=__mp4

Which would return the shapeId of the proxy shape(s)

Resources

Resources specific to this UC:

https://apidoc.vidispine.com/latest/ref/item/transcode.html#transcode-an-item

https://apidoc.vidispine.com/latest/ref/item/import.html#importing-an-item

Please see more information in:

Single-File Videos [C ARC]

How to

Please view the explanation in:

https://apidoc.vidispine.com/latest/item/shape.html#transcoding