Query a Transcoding Preset
Query the transcoding preset with preset name.
Request
Request-Line
GET /lls/v1.0/preset/{presetName}
Response
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| 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 frame per second. |
| videoGop | Integer | Optional | Video group of picture. |
| 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, check API calls to comply with the rate limit below:
- 100 requests per minute
- 1000 requests per hour