Job with input clipping
In some cases, you might want to apply a transform to only a specific portion of the source asset. MK.IO enables this by allowing you to set time for the input in the job configuration.
Setting a time range to a job input is not exposed in the UI and must be configured using the job endpoint in MK.IO API.
MK.IO jobs support two types of input: #Microsoft.Media.JobInputAsset
and #Microsoft.Media.JobInputHttp
. Both input types can be clipped prior to applying the transform.
The start and end parameters can be either relative to the content using #Microsoft.Media.AbsoluteClipTime
or based on UTC time using #Microsoft.Media.UtcClipTime
. For VOD content, UTC time is applicable, in this case absolute clip time should be used instead.
Use absolute time to transcode a portion of an asset
Below is a sample job that generates a new asset containing only the first 3 minutes of an input asset.
curl --request PUT \
--url https://api.io.mediakind.com/api/ams/project_name/transforms/transform_name/jobs/job_name \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer bearer-token' \
--data '
{
"properties": {
"input": {
"files": [
"my_asset.mp4"
],
"assetName": "myasset",
"@odata.type": "#Microsoft.Media.JobInputAsset",
"start":
{
"@odata.type":"#Microsoft.Media.AbsoluteClipTime",
"time":"PT0S"
},
"end":
{
"@odata.type":"#Microsoft.Media.AbsoluteClipTime",
"time":"PT3M"
}
},
"outputs": [
{
"assetName": "clipped-asset",
"@odata.type": "#Microsoft.Media.JobOutputAsset"
}
]
}
}
'
Use UTC time to clip a live event
Below is a sample job that can be applied to a live event asset to extract a specific time range between two UTC values:
curl --request PUT \
--url https://api.io.mediakind.com/api/ams/project_name/transforms/transform_name/jobs/job_name \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer bearer-token' \
--data '
{
"properties": {
"input": {
"files": [
""
],
"assetName": "live-event-output",
"@odata.type": "#Microsoft.Media.JobInputAsset",
"start":
{
"@odata.type":"#Microsoft.Media.UtcClipTime",
"time":"2024-07-26T08:30:00.000Z"
},
"end":
{
"@odata.type":"#Microsoft.Media.UtcClipTime",
"time":"2024-07-26T08:40:00.000Z"
}
},
"outputs": [
{
"assetName": "clipped-asset",
"@odata.type": "#Microsoft.Media.JobOutputAsset"
}
]
}
}
'
Updated 28 days ago