Learn how to ingest, store, and deliver your videos in 4K resolutions
Mux Video supports ingesting, storing, and delivering on-demand video assets in high resolutions up to and including 4K (2160p).
Much premium video content is created in 4K, but more recently user-generated content is often in 4k as well, as mobile devices are increasingly capable of producing 4K video.
Mux Video also supports 2K and 2.5K video on-demand video assets.
To ingest, store, and deliver an asset in 4K, you'll need to set the new max_resolution_tier
attribute on your create-asset API callAPI.
// POST /video/v1/assets
{
"input": "https://storage.googleapis.com/muxdemofiles/mux-4k.mp4",
"playback_policy": [
"public"
],
"video_quality": "plus",
"max_resolution_tier": "2160p"
}
This field controls the maximum resolution that we'll encode, store, and deliver your media in. We do not to automatically ingest content at 4K so that you can avoid unexpectedly high ingest bills. If you send us 4K content today and don't set max_resolution_tier
, nothing changes in your bill.
This also allows you to build applications where some of your content creators are able to upload 4K content while others remain capped at 1080p.
And of course you can use 4K with Direct Uploads, too; you just need to set the same "max_resolution_tier": "2160p"
field in the new_asset_settings
of your create-direct-upload API callAPI.
// POST /video/v1/uploads
{
"new_asset_settings": {
"playback_policy": [
"public"
],
"video_quality": "plus",
"max_resolution_tier": "2160p"
},
"cors_origin": "*"
}
For assets with 4K enabled at ingest, we'll automatically add 2K and 4K renditions to your HLS Playback URLs. Mux uses high-bitrate H.264 for delivering 4K content, which is supported on a wide range of devices, like Mux Player shown below.
While we've tested playback and built device detection rules that should protect you against unexpected playback failures, you should always test playback on your own device footprint before enabling 4K widely on your platform.
Of course, you might not want all of your viewers to be able to view your content in 4K. Lots of streaming platforms choose to only offer 4K playback to their high subscription tiers. You can implement this by controlling playback resolution with the max_resolution query parameter on your playback URLs, as shown below.
https://stream.mux.com/${PLAYBACK_ID}.m3u8?max_resolution=1080p
Mux uses just-in-time (JIT) encoding to make sure your assets are available as soon as possible after you create them, and this includes 4K assets.
Most of the usual restrictions for standard inputs still apply when you're using 4K, but there are a few different restrictions you should be aware of:
Mux Video also supports 2K and 2.5K (1440p) content. If you want your asset processed as 2/2.5K, you just need to set "max_resolution_tier": "1440p"
in your create asset (or create direct upload) calls instead.