Transcoding

Transcoding

Start an item transcode job

POST /item/(item-id)/transcode

Starts a new job that transcode an item to a number of shapes according to the given shape tags.

Query Parameters:
 
  • tag – A comma-separated list of shape tags, that specify the desired output.
  • createThumbnails
    • true - Creates thumbnails according to default transcoder rules.
    • false (default) - No thumbnails will be created.
  • createPosters – An optional list of time codes to use for creating posters.
  • thumbnailService – An optional identifier to which thumbnail resource that should be used.
  • destinationItem

    An item id, to which the new new shape will be associated.

    New in version 4.4.

  • original

    An optional tag, if specified it should be one of the tags specified in the tag parameter. Specifies that the original shape tag will be reset to the shape created to this tag.

    New in version 4.6.

  • resourceId

    The transcoder resource to use to execute the transcode.

    New in version 4.11.

  • overrideFastStart
    • true (default) - Use transcoder’s estimate of the duration for allocating header space in MOV files and similar files.
    • false - Do not use the transcoder’s estimate of the duration.
  • requireFastStart
    • true (default) - Try to put the index tables (header) in front of the file.
    • false - Put header at end of file.
  • fastStartLength – Optional estimated duration of the clip in seconds.
  • notification – The placeholder job notification to use for this job. (Optional)
  • notificationData – Any additional data to include for notifications on this job. (Optional)
  • priority – The priority to assign to the job. Default is MEDIUM .
  • jobmetadata – Additional information for the job task.
Produces:
Role:

_job_write

Start a shape transcode job

POST /item/(item-id)/shape/(shape-id)/transcode

Starts a new job that transcode a specific shape on an item to a number of shapes according to the given shape tags.

Query Parameters:
 
  • tag – A comma-separated list of shape tags, that specify the desired output.
  • createThumbnails
    • true - Creates thumbnails according to default transcoder rules.
    • false (default) - No thumbnails will be created.
  • createPosters – An optional list of time codes to use for creating posters.
  • thumbnailService – An optional identifier to which thumbnail resource that should be used.
  • destinationItem

    An item id, to which the new new shape will be associated.

    New in version 4.4.

  • original

    An optional tag, if specified it should be one of the tags specified in the tag parameter. Specifies that the original shape tag will be reset to the shape created to this tag.

    New in version 4.6.

  • resourceId

    The transcoder resource to use to execute the transcode.

    New in version 4.11.

  • overrideFastStart
    • true (default) - Use transcoder’s estimate of the duration for allocating header space in MOV files and similar files.
    • false - Do not use the transcoder’s estimate of the duration.
  • requireFastStart
    • true (default) - Try to put the index tables (header) in front of the file.
    • false - Put header at end of file.
  • fastStartLength – Optional estimated duration of the clip in seconds.
  • notification – The placeholder job notification to use for this job. (Optional)
  • notificationData – Any additional data to include for notifications on this job. (Optional)
  • priority – The priority to assign to the job. Default is MEDIUM .
  • jobmetadata – Additional information for the job task.
Produces:
Role:

_job_write