Create a Transcoding Preset

Create a transcoding or transmuxing preset.

Request

Request-Line

POST /lls/v1.0/preset

Request

Request 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 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.

Response

Response Body

Parameter	Type	Required	Description
preset	String	Mandatory	preset name
created	Timestamp	Mandatory	Timestamp of created time in UTC timezone. Default is now.
status	String	Mandatory	Status of domain. Valid values: active, inactive.

Examples

Create a Transcoding Preset

This example creates a standard transcoding preset for a 1080p HD stream.

Request

POST /lls/v1.0/preset HTTP/1.1

{
  "preset": "preset_hd_h264",
  "videoBitrate": 2000,
  "videoWidth": 1920,
  "videoHeight": 1080,
  "videoFps": 30,
  "videoGop": 60,
  "videoProfile": "high",
  "videoCodec": "h264",
  "audioBitrate": 128,
  "audioChannels": "stereo",
  "audioSampleRate": 48000,
  "audioCodec": "aac"
}

Successful Response Body

{
  "preset": "preset_hd_h264",
  "created": "2025-07-10T19:19:51Z",
  "status": "active"
}

---

Create a Transmuxing Preset

This example creates a transmuxing (passthrough) preset. When videoTransmux is true, all video-related parameters are ignored, and the original video track is passed through without transcoding. When audioTransmux is true, all audio-related parameters are ignored, and the original audio track is passed through without transcoding.

Request

POST /lls/v1.0/preset HTTP/1.1

{
  "preset": "preset_passthrough",
  "videoTransmux": true,
  "audioTransmux": true
}

Successful Response Body

{
  "preset": "preset_passthrough",
  "created": "2025-07-10T19:20:10Z",
  "status": "active"
}

Create a Preset with only Audio

This example creates a transmuxing (passthrough) preset. When onlyAudio is true, the original video track is ignored.

Request

POST /lls/v1.0/preset HTTP/1.1

{
  "preset": "preset_passthrough",
  "onlyAudio": true,
  "audioBitrate": 128,
  "audioChannels": "stereo",
  "audioSampleRate": 48000,
  "audioCodec": "aac"
}

Successful Response Body

{
  "preset": "preset_passthrough",
  "created": "2025-07-10T19:20:10Z",
  "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