List Transcoding Templates
Request
Request-Line
GET /lls/v1.0/template/transcoding
Request
Query Parameters
Name | Type | Required | Description |
---|---|---|---|
domain | String | Optional | ingest domain name |
app | String | Optional | app name. if not specified, the transcoding template will be applied to all apps. |
stream | String | Optional | stream name. if not specified, the transcoding template will be applied to all streams. |
status | String | Optional | status of transcoding template. Valid values: active, inactive. |
Response
Response Body
Parameter | Type | Required | Description |
---|---|---|---|
templates | Array | Mandatory | Array of Transcoding Template Object. |
Object:Transcoding Template
Name | Type | Required | Description |
---|---|---|---|
templateName | String | Mandatory | transcoding template name. |
created | Timestamp | Mandatory | Timestamp of created time in UTC timezone. Default is now. |
status | String | Mandatory | Status of transcoding template. Valid values: active, inactive. |
domain | String | Mandatory | ingest domain name |
app | String | Optional | app name. if not specified, the transcoding template will be applied to all apps. |
stream | String | Optional | stream name. if not specified, the transcoding template will be applied to all streams. |
deliveryProtocol | Array | Mandatory | delivery protocol. Valid values: http-flv, ll-hls, hls,dash. |
transcodingPresets | Array | Mandatory | the names of transcoding presets for delivery stream. the special preset named 'transmux' will package the ingest stream without any transcoding. |
Examples
List all transcoding templates
Request
GET /lls/v1.0/template/transcoding HTTP/1.1
Successful Response Body
{
"templates": [
{
"templateName": "domainTemplate",
"created": "2025-07-15T08:47:10Z",
"status": "active",
"domain": "ingest.example.com",
"deliveryProtocol": ["ll-hls", "hls", "dash"],
"transcodingPresets": ["720p", "480p", "360p"]
},
{
"templateName": "appTemplate",
"created": "2025-07-15T08:48:30Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"deliveryProtocol": ["http-flv", "ll-hls"],
"transcodingPresets": ["1080p", "720p", "480p"]
},
{
"templateName": "streamTemplate",
"created": "2025-07-15T08:49:45Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"stream": "stream1",
"deliveryProtocol": ["ll-hls"],
"transcodingPresets": ["4k", "1080p", "720p"]
},
{
"templateName": "transmuxTemplate",
"created": "2025-07-15T08:51:30Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"deliveryProtocol": ["ll-hls", "http-flv"],
"transcodingPresets": ["transmux"]
}
]
}
List transcoding templates filtered by domain and app
Request
GET /lls/v1.0/template/transcoding?domain=ingest.example.com&app=live HTTP/1.1
Response
{
"templates": [
{
"templateName": "appTemplate",
"created": "2025-07-15T08:48:30Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"deliveryProtocol": ["http-flv", "ll-hls"],
"transcodingPresets": ["1080p", "720p", "480p"]
},
{
"templateName": "streamTemplate",
"created": "2025-07-15T08:49:45Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"stream": "stream1",
"deliveryProtocol": ["ll-hls"],
"transcodingPresets": ["4k", "1080p", "720p"]
},
{
"templateName": "transmuxTemplate",
"created": "2025-07-15T08:51:30Z",
"status": "active",
"domain": "ingest.example.com",
"app": "live",
"deliveryProtocol": ["ll-hls", "http-flv"],
"transcodingPresets": ["transmux"]
}
]
}
List inactive transcoding templates
Request
GET /lls/v1.0/template/transcoding?status=inactive HTTP/1.1
Successful Response Body
{
"templates": [
{
"templateName": "oldTemplate",
"created": "2025-07-10T14:30:22Z",
"status": "inactive",
"domain": "ingest.example.com",
"app": "vod",
"deliveryProtocol": ["hls", "dash"],
"transcodingPresets": ["1080p", "720p"]
},
{
"templateName": "deprecatedTemplate",
"created": "2025-07-08T09:15:40Z",
"status": "inactive",
"domain": "ingest.example2.com",
"deliveryProtocol": ["http-flv"],
"transcodingPresets": ["480p", "360p"]
}
]
}
Best Practices
Rate Limiting
Rate Limits
Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:
- 100 requests per minute
- 1000 requests per hour