This endpoint allows you to update the mp4Support setting of an existing media file using its media ID. You can specify the MP4 support level, such as none, capped_4k, audioOnly, or a combination of audioOnly,capped_4k, in the request payload.
How it works
-
Send a PATCH request to /on-demand/{mediaId}/update-mp4Support, replacing
{mediaId}with the media ID. -
Provide the desired mp4Support value in the request body.
-
Receive a response confirming the update, including the media’s updated MP4 support status.
MP4 Support Options
-
none – MP4 support is disabled for this media.
-
capped_4k – The media will have mp4 renditions up to 4K resolution.
-
audioOnly – The media will generate an m4a file containing only the audio track.
-
audioOnly,capped_4k – The media will have both an audio-only m4a file and mp4 renditions up to 4K resolution.
Webhook Events
- video.media.mp4Support.updated – Triggered when the MP4 support setting is successfully updated.
Use case: Suppose you have a video uploaded to the FastPix platform, and you want to allow users to download the video in MP4 format. By setting "mp4Support": "capped_4k", the system will generate an MP4 rendition of the video up to 4K resolution, making it available for download via the stream URL(https://stream.fastpix.io/{playbackId}/{capped-4k.mp4 | audio.m4a}).
If you want users to stream only the audio from the media file, you can set "mp4Support": "audioOnly". This will provide an audio-only stream URL that allows users to listen to the media without video.
By setting "mp4Support": "audioOnly,capped_4k", both options will be enabled. Users will be able to download the MP4 video and also stream just the audio version of the media