VMRack

Update Preset

Update Preset

Request Parameters

Path Parameter

idstring
Required

Preset ID, must be greater than or equal to 1

Body Parameter

transcoding_presetobject
Optional

Transcoding Preset

preset_namestring
Optional

Transcoding preset name

container_formatnumber
Optional

Container Format

0: MP4

1: MKV

2: HLS

video_paramsobject
Optional

Video Parameters

codecnumber
Optional

Video Codec

0: H264

1: H265

2: AV1

bitrate_paramsobject
Optional

Bitrate Config

bitrate_typenumber
Optional

Bitrate Config Type

0: Default

1: Constant Bitrate (CBR)

2: CRF

valuenumber
Optional

Bitrate config value

resolution_paramsobject
Optional

Resolution Config

resolution_typenumber
Optional

Resolution Config Type

0: Original Resolution

1: 4K

2: 2K

3: 1080P

4: 720P

5: 480P

6: Custom Resolution

widthnumber
Optional

Resolution Width

heightnumber
Optional

Resolution Height

aspect_paramsobject
Optional

Display Aspect Ratio Config

aspect_typenumber
Optional

Display Aspect Ratio Config Type

0: Original Aspect Ratio

1: 16:10

2: 16:9

3: 4:3

4: 1:1

5: Custom Aspect Ratio

widthnumber
Optional

Custom display width

heightnumber
Optional

Custom display height

remove_black_barsboolean
Optional

Whether to remove black bars

video_scalingobject
Optional

Scaling config, null means not set

scaling_typenumber
Optional

Scaling Config Type

0: Stretch

1: Letterbox

framerate_paramsobject
Optional

Video framerate config, null means not set

valuenumber
Optional

Custom framerate value

gop_paramsobject
Optional

Keyframe config, null means not set

valuenumber
Optional

Custom keyframe value

clip_segment_paramsobject
Optional

Clip segment config, null means not set

start_timenumber
Optional

Start time (seconds)

durationnumber
Optional

Duration (seconds)

segment_durationnumber
Optional

Segment duration, required for HLS type

audio_paramsobject
Optional

Audio Parameters

disable_audioboolean
Optional

Whether to disable audio

codecnumber
Optional

Audio Codec

0: Default

2: MP3

1: AAC

3: ACC_HE

channelsnumber
Optional

Audio channel config, 0 means keep original. Note: channels must match audio codec, otherwise transcoding or output may fail

bitrate_paramsobject
Optional

Audio Bitrate Config

bitrate_typenumber
Optional

Audio Bitrate Config Type

0: Default

1: 96k

2: 128K

3: 192K

4: 256K

5: 320K

6: Custom

valuenumber
Optional

Audio bitrate config value

sample_rate_paramsobject
Optional

Audio Sample Rate Config

sample_rate_typenumber
Optional

Audio Sample Rate Config Type

0: Default

1: 8000

2: 11025

3: 12000

4: 16000

5: 22050

6: 24000

7: 32000

8: 44100

9: 48000

10: 64000

11: 88200

12: 96000

20: Custom

valuenumber
Optional

Audio sample rate config value

subtitle_paramsobject
Optional

Subtitle Parameters

disable_subtitleboolean
Optional

Whether to disable subtitle

subtitle_fileobject
Optional

input file list

bucketstring
Optional

Bucket name

object_namestring
Optional

Object Name

ffy_oss_idstring
Optional

Cloud Storage Data ID

subtitle_placeholdernumber
Optional

Subtitle placeholder, 1-based, 0 means no subtitle

hardcode_subtitleboolean
Optional

Whether to convert soft subtitle to hard subtitle

subtitle_indexnumber
Optional

Subtitle index, 0-based

watermark_presetobject
Optional

Watermark Preset

preset_namestring
Optional

Watermark preset name

watermark_paramsobject
Optional

Watermark Configuration Details

watermark_typenumber
Optional

Watermark Type

0: Text

1: Image

watermark_text_paramsobject
Optional

Text Watermark Configuration

textstring
Optional

Text watermark content

fontnumber
Optional

Watermark Text Font

0: FangZheng Song

1: FangZheng Hei

2: FangZheng Kai

3: MapleMono

font_sizenumber
Optional

Text watermark font size (PX)

font_colorstring
Optional

Text watermark color

add_borderboolean
Optional

Whether to add text border

border_widthnumber
Optional

Border width (1-5PX)

border_colorstring
Optional

Border color (hex color value)

border_opacitynumber
Optional

Border opacity (0-1.0)

italicboolean
Optional

Whether italic

boldboolean
Optional

Whether bold

watermark_image_paramsobject
Optional

Image Watermark Configuration

image_fileobject
Optional

input file list

bucketstring
Optional

Bucket name

object_namestring
Optional

Object Name

ffy_oss_idstring
Optional

Cloud Storage Data ID

image_scaling_paramsobject
Optional

Image Scaling Config

rationumber
Optional

Scaling ratio, (0-1], ratio of watermark to video size

watermark_positionnumber
Optional

Watermark Position

0: Top Left

4: Top Center

2: Top Right

1: Middle Left

5: Center

3: Middle Right

6: Bottom Left

7: Bottom Center

8: Bottom Right

margin_xnumber
Optional

Watermark Horizontal Margin (px)

margin_ynumber
Optional

Watermark vertical margin (px)

watermark_timeline_paramsobject
Optional

Watermark Timeline Configuration

start_typenumber
Optional

Watermark Timeline Start Type

0: From Beginning

1: From End

start_timenumber
Optional

Start time (seconds)

durationnumber
Optional

Duration (seconds)

watermark_animationboolean
Optional

Watermark animation

watermark_end_positionnumber
Optional

Watermark Position

0: Top Left

4: Top Center

2: Top Right

1: Middle Left

5: Center

3: Middle Right

6: Bottom Left

7: Bottom Center

8: Bottom Right

watermark_end_margin_xnumber
Optional

Watermark End Horizontal Margin (px)

watermark_end_margin_ynumber
Optional

Watermark End Vertical Margin (px)

watermark_animation_time_modenumber
Optional

Watermark Animation Time Mode

0: Once

1: Repeat

watermark_animation_start_timenumber
Optional

Watermark Animation Start Time

watermark_animation_intervalnumber
Optional

Watermark Animation Interval

watermark_animation_durationnumber
Optional

Watermark Animation Duration

screenshot_presetobject
Optional

Screenshot Preset

preset_namestring
Optional

Screenshot preset name

screenshot_paramsobject
Optional

Screenshot Config

screenshot_preset_idstring
Optional

Screenshot Preset ID

screenshot_typenumber
Optional

Screenshot Type

0: Single

1: Multiple

container_formatnumber
Optional

Screenshot Container Format

0: JPEG

1: PNG

resolution_paramsobject
Optional

Resolution Config

resolution_typenumber
Optional

Resolution Config Type

0: Original Resolution

1: 4K

2: 2K

3: 1080P

4: 720P

5: 480P

6: Custom Resolution

widthnumber
Optional

Resolution Width

heightnumber
Optional

Resolution Height

start_timenumber
Optional

Screenshot start time (seconds)

durationnumber
Optional

Screenshot duration (seconds), required for multiple screenshots

intervalnumber
Optional

Screenshot interval (seconds), required for multiple screenshots

interval_typenumber
Optional

Screenshot Interval Type

0: Second

1: Percent

interval_percentnumber
Optional

Screenshot interval percent (1-100)

time_modenumber
Optional

Screenshot Time Mode

0: Precise Time

1: Percent Range

start_percentnumber
Optional

Screenshot start percent (only valid for percent mode)

end_percentnumber
Optional

Screenshot end percent (only valid for percent mode)

screenshot_countnumber
Optional

Screenshot count, only valid for percent mode

concatenation_presetobject
Optional

Video Concatenation Preset

preset_namestring
Optional

Video concatenation preset name

video_concatenation_paramsobject
Optional

Video Concatenation Config

concatenation_preset_idstring
Optional

Concatenation Preset ID

container_formatnumber
Optional

Video Concatenation Container Format

0: MP4

1: MKV

resolution_paramsobject
Optional

Resolution Config

resolution_typenumber
Optional

Resolution Config Type

0: Original Resolution

1: 4K

2: 2K

3: 1080P

4: 720P

5: 480P

6: Custom Resolution

widthnumber
Optional

Resolution Width

heightnumber
Optional

Resolution Height

max_bitrateobject
Optional

Peak bitrate config, null means not set

valuenumber
Optional

Peak bitrate config value

input_filesobject[]
Optional

Concatenation input file list

bucketstring
Optional

Bucket name

object_namestring
Optional

Object Name

ffy_oss_idstring
Optional

Cloud Storage Data ID

pad_audioboolean
Optional

Whether to pad audio for videos without audio track

add_black_bordersboolean
Optional

Whether to add black borders

source_indexnumber
Optional

Source video position, 0 means the first video in the index

VMRack