Skip to main content

List Transcoding Templates

Request

Request-Line

GET /lls/v1.0/template/transcoding

Request

Query Parameters

NameTypeRequiredDescription
domainStringOptionalingest domain name
appStringOptionalapp name. if not specified, the transcoding template will be applied to all apps.
streamStringOptionalstream name. if not specified, the transcoding template will be applied to all streams.
statusStringOptionalstatus of transcoding template. Valid values: active, inactive.

Response

Response Body

ParameterTypeRequiredDescription
templatesArrayMandatoryArray of Transcoding Template Object.

Object:Transcoding Template

NameTypeRequiredDescription
templateNameStringMandatorytranscoding template name.
createdTimestampMandatoryTimestamp of created time in UTC timezone. Default is now.
statusStringMandatoryStatus of transcoding template. Valid values: active, inactive.
domainStringMandatoryingest domain name
appStringOptionalapp name. if not specified, the transcoding template will be applied to all apps.
streamStringOptionalstream name. if not specified, the transcoding template will be applied to all streams.
deliveryProtocolArrayMandatorydelivery protocol. Valid values: http-flv, ll-hls, hls,dash.
transcodingPresetsArrayMandatorythe 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