hls_url
contains a URL to the manifest (.m3u8) that tells players the order in which they should play the chunks into which the video is divided.
The hls_cmaf_url
contains a URL to the master playlist HLS (master-cmaf.m3u8) with CMAF-based chunks. The chunks are in the fMP4 container, which is codec-agnostic and allows the use of anything like H264, H265, or AV1.
Considering the existing limitations of the old HLS, it’s important to understand how the manifest and chunks will be formed. Chunk type is selected automatically according to the used type of video codec:
{client_id}
: Your account ID.{video_slug}
: Slug identifier of the video.[-cmaf]
: The HLS CMAF version of the manifest. For details, check the hls_cmaf_url field description in our API docs.[-min-N]
: Special suffix that specifies the lowest video quality limit available in an Adaptive Bitrate (ABR) streaming. Learn more about the setting in the Limit quality section.[-max-N]
: Special suffix that specifies the highest video quality limit available in the ABR streaming. Learn more about the setting in the Limit quality section.[-img]
: The trick play feature for Roku devices allows thumbnail images to be embedded directly into the manifest. Read more in the article Timeline hover previews: use with players and Roku devices.[-(h264|hevc|av1)]
: Video codec soft limitation. Applicable if the video was simultaneously transcoded into multiple codecs (264, H265, and AV1) and you want to return just one video codec in a manifest.{client_id}
: Your account ID.{video_slug}
: Slug identifier of the video.[-min-N]
: Special suffix that specifies the lowest video quality limit available in an Adaptive Bitrate (ABR) streaming (same behaviour as for HLS). Learn more about the setting in the Limit quality section.[-max-N]
: Special suffix that specifies the highest video quality limit available in the ABR streaming (same behaviour as for HLS). Learn more about the setting in the Limit quality section.[-(h264|hevc|av1)]
: Video codec soft limitation. Applicable if the video was simultaneously transcoded into multiple codecs (264, H265, and AV1) and you want to return just one video codec in a manifest.iframe_url
contains a web player linkiframe_embed_code
contains web player embed codehls_url
contains the HLS linkhls_cmaf_url
contains the HLS link with CMAF chunksdash_url
contains the MPEG-DASH linkmp4_url
contains the MP4 link-min-N
: minimum resolution not less than specified-max-N
: maximum resolution not exceeding than specifiedN
is a resolution (height or width) from 240 to 9999. If the video is horizontally oriented, the resolution is its height. If it’s vertically oriented, it should be width.
Here’s an example of how to get two qualities only—360 and 480—instead of the full set for HLS (the same can be done for MPEG-DASH manifest .mpd):