Query a Transcoding Preset
Request
Request-Line
GET /lls/v1.0/preset/{presetName}
Response
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| preset | String | Mandatory | preset name |
| preset | String | Mandatory | preset name |
| onlyAudio | Boolean | Optional | only audio. default is false. |
| videoTransmux | Boolean | Optional | enable video transmuxing. default is false. if true, following video parameters are ignored. |
| videoBitrate | Integer | Optional | video bitrate in kbps. |
| videoWidth | Integer | Optional | video width in pixels. |
| videoHeight | Integer | Optional | video height in pixels. |
| videoFps | Integer | Optional | video fps. |
| videoGop | Integer | Optional | video gop. |
| videoProfile | String | Optional | video profile. valid values: baseline, main, high. |
| videoCodec | String | Optional | video codec. valid values: h264, h265. |
| audioTransmux | Boolean | Optional | enable audio transmuxing. default is false. if true, following audio parameters are ignored. |
| audioBitrate | Integer | Mandatory | audio bitrate in kbps. |
| audioChannels | String | Mandatory | audio channels. valid values: stereo, mono. |
| audioSampleRate | Integer | Mandatory | audio sample rate. valid values: 44100, 48000. |
| audioCodec | String | Mandatory | audio codec. valid values: aac. |
| created | Timestamp | Mandatory | Timestamp of created time in UTC timezone. Default is now. |
| status | String | Mandatory | Status of domain. Valid values: active, inactive. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | LLS.TranscodingPreset.NotFound | Transcoding Preset not found. |
Examples
Query a Transcoding Preset
This example shows how to query the configuration of a specific transcoding preset named preset_hd_h264.
Request
GET /lls/v1.0/preset/preset_hd_h264 HTTP/1.1
Successful Response Body
{
"preset": "preset_hd_h264",
"transmuxing": false,
"videoBitrate": 2000,
"videoWidth": 1920,
"videoHeight": 1080,
"videoFps": 30,
"videoGop": 60,
"videoProfile": "high",
"videoCodec": "h264",
"audioBitrate": 128,
"audioChannels": "stereo",
"audioSampleRate": 48000,
"audioCodec": "aac",
"created": "2025-07-10T19:19:51Z",
"status": "active"
}
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