Sign in

v1

latestOpenAPI 3.1.02026-07-24251250397.8 KB
custom renditions

Create a custom audio rendition

Creates a new custom audio rendition. This is only applicable to media with a renditions hosting type.

Renditions must adhere to custom renditions guidelines.

post/v2/sites/{site_id}/media/{media_id}/custom_audio_renditions/

Path parameters

site_idstring required

Unique identifier for a resource

Example:Ny05CEfj

Unique alphanumeric ID of the site

media_idstring required

Unique identifier for a resource

Example:Ny05CEfj

Unique alphanumeric ID of the media

Request body

Response

Custom Audio Rendition Resource

idstring

Unique identifier for a resource

status'created' | 'processing' | 'ready' | 'failed'

Custom rendition status

kindstring[]

This decides how the track is handled by the user agent for accessibility features. It is extracted from the provided rendition. To change the “kind” value, a new rendition with the desired value must be added. An empty array indicates that no explicit kind is provided or the kind given by the track's metadata is not recognized by the user agent.

Suggested Values:

  • about:html-kind@alternative: A possible alternative to the main track, e.g. a different take of a song (audio)
  • about:html-kind@descriptions: An audio description of a video track
  • about:html-kind@main: The primary audio track
  • about:html-kind@main-desc: Primary audio track mixed with audio descriptions
  • about:html-kind@translation: Translated version of the primary audio track
  • about:html-kind@commentary: Commentary on the primary audio track (such as a director's commentary)

NOTE: kind indicates how a track should be handled (such as its accessibility category), whereas role indicates what editorial or functional purpose the track serves, as defined in CTA-5005-A. The two are independent and can be used together.

codecstring
sizeinteger

Size of the custom audio rendition, in bytes

bit_rateinteger

Bit rate of the custom audio rendition in bits per second

error_messagestring

A human-readable error message for describing failures

createdstring date-time

Date and time at which the resource was created in JWX

last_modifiedstring date-time

Date and time at which the resource was most recently modified

Example response

{
  "id": "aBcD1234",
  "created": "2018-10-02T21:19:36.602019+00:00",
  "last_modified": "2018-10-02T21:19:36.602019+00:00"
}