v50

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-2810050281.4 KB

Media Assets

Add Rendition

Add a remote rendition to the given video. Note: you can use /videos/ref:reference_id instead of /videos/video_id

post/v1/accounts/{{account_id}}/videos/{{video_id}}/assets/renditions

Path parameters

account_idstring required

Video Cloud account ID.

video_idstring required

Video ID (specified as {video_id}}).

Headers

Content-Typestring required

Content-Type: application/json

Authorizationstring required

Authorization: Bearer {access_token} - see Getting Access Tokens

Request body

account_idstring

the Video Cloud account id

audio_onlyboolean

this rendition contains only an audio track, no video track (a rendition for low bandwidth devices)

cdn_origin_idstring

an internally used id (not applicable to remote assets)

completeboolean

whether processing is complete for the asset (will be true for remote assets if a remote_url is supplied)

controller_typestring

the controller type for ingested renditions (not applicable to remote renditions or other types of assets)

current_filenamestring

the filename for an ingested asset in the Video Cloud system (not applicable to remote assets)

encoding_rateinteger

average encoding rate in kbps

frame_heightinteger

frame height in pixels

frame_widthinteger

frame width in pixels

idstring

the asset id

key_systemsstring[]

array of strings that denote the kind of encryption used for DRM packaged renditions

namestring

asset name

progressive_downloadboolean

whether ingested rendition is available by progressive download (not applicable to other asset types or remote renditions)

reference_idstring

the media asset reference id (must be unique within the account) - this is not the same as the video reference id

remote_stream_namestring

name for remote streams (not applicable to asset types other than rendition)

remote_urlstring

the url for a remote asset (not applicable to ingested assets); remote_url is required when adding an asset (POST)

sizeinteger

the size of the asset in bytes (integer)

typestring

the type of the asset

updated_atstring

when the video was last modified

uploaded_atstring

when the asset was added to the video in Video Cloud

video_codecstring

not applicable to remote assets

video_containerstring

not applicable to remote assets

video_durationinteger

duration in milliseconds

Response

Rendition asset created

account_idstring

the Video Cloud account id

audio_onlyboolean

this rendition contains only an audio track, no video track (a rendition for low bandwidth devices)

cdn_origin_idstring

an internally used id (not applicable to remote assets)

completeboolean

whether processing is complete for the asset (will be true for remote assets if a remote_url is supplied)

controller_typestring

the controller type for ingested renditions (not applicable to remote renditions or other types of assets)

current_filenamestring

the filename for an ingested asset in the Video Cloud system (not applicable to remote assets)

encoding_rateinteger

average encoding rate in kbps

frame_heightinteger

frame height in pixels

frame_widthinteger

frame width in pixels

idstring

the asset id

key_systemsstring[]

array of strings that denote the kind of encryption used for DRM packaged renditions

namestring

asset name

progressive_downloadboolean

whether ingested rendition is available by progressive download (not applicable to other asset types or remote renditions)

reference_idstring

the media asset reference id (must be unique within the account) - this is not the same as the video reference id

remote_stream_namestring

name for remote streams (not applicable to asset types other than rendition)

remote_urlstring

the url for a remote asset (not applicable to ingested assets); remote_url is required when adding an asset (POST)

sizeinteger

the size of the asset in bytes (integer)

typestring

the type of the asset

updated_atstring

when the video was last modified

uploaded_atstring

when the asset was added to the video in Video Cloud

video_codecstring

not applicable to remote assets

video_containerstring

not applicable to remote assets

video_durationinteger

duration in milliseconds