Skip to main content
Skip table of contents

Transcoding [VC 21.3.1 GEN]

Transcoding

Transcode an item

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 (string) – Comma-separated list of shape tags, that specify the desired output.

  • createThumbnails (boolean) –

    • true (default) - Creates thumbnails according to default transcoder rules.

    • false - No thumbnails will be created.

  • createPosters (string) – A list of time codes to use for creating posters.

  • thumbnailService (string) – Identifies which thumbnail resource that should be used.

  • destinationItem (string) – An item id, to which the new new shape will be associated.

  • original (string) – If specified, 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.

  • resourceId (string) – The transcoder resource to use to execute the transcode.

  • storageId (string) –

    Identifier of storage where essence file is to be stored.

    New in version 4.16.

  • overrideFastStart (boolean) –

    • 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 (boolean) –

    • true (default) - Try to put the index tables (header) in front of the file.

    • false - Put header at end of file.

  • fastStartLength (string) – Estimated duration of the clip in seconds.

  • notification (string) – The placeholder job notification to use for this job.

  • notificationData (string) – Any additional data to include for notifications on this job.

  • priority (string) – The priority to assign to the job. Default is MEDIUM .

  • jobmetadata (string[]) – Additional information for the job task.

Produces:
Role:

_job_write

Transcode a specific shape

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 (string) – Comma-separated list of shape tags, that specify the desired output.

  • createThumbnails (boolean) –

    • true (default) - Creates thumbnails according to default transcoder rules.

    • false - No thumbnails will be created.

  • createPosters (string) – A list of time codes to use for creating posters.

  • thumbnailService (string) – Identifies which thumbnail resource that should be used.

  • destinationItem (string) – An item id, to which the new new shape will be associated.

  • original (string) – If specified, 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.

  • resourceId (string) – The transcoder resource to use to execute the transcode.

  • storageId (string) –

    Identifier of storage where essence file is to be stored.

    New in version 4.16.

  • overrideFastStart (boolean) –

    • 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 (boolean) –

    • true (default) - Try to put the index tables (header) in front of the file.

    • false - Put header at end of file.

  • fastStartLength (string) – Estimated duration of the clip in seconds.

  • notification (string) – The placeholder job notification to use for this job.

  • notificationData (string) – Any additional data to include for notifications on this job.

  • priority (string) – The priority to assign to the job. Default is MEDIUM .

  • jobmetadata (string[]) – Additional information for the job task.

Produces:
Role:

_job_write

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.