MediaConvertJobFeature

Parameter	Type	Description	Example
	object	Parameters for transcoding features.
Clip	object	Clip settings.
TimeSpan	object	The time span for the clip.
Seek	string	Specifies the start time of the clip. If this parameter is not set, the clip starts from the beginning of the video. Format: `hh:mm:ss[.SSS]` or `sssss[.SSS]`. Value range: `[00:00:00.000, 23:59:59.999]` or `[0.000, 86399.999]`. Example: `00:01:59.999` or `180.30`.	180.30
Duration	string	Specifies the duration of the clip, relative to the `Seek` time. By default, the clip extends to the end of the video. You can specify either `Duration` or `End`, but not both. If `End` is specified, `Duration` is ignored. Format: `hh:mm:ss[.SSS]` or `sssss[.SSS]`. Value range: `[00:00:00.000, 23:59:59.999]` or `[0.000, 86399.999]`. Example: `00:01:59.999` or `180.30`.	60.0
End	string	Specifies the end time of the clip. You can specify either `End` or `Duration`, but not both. If `End` is specified, `Duration` is ignored. Format: `hh:mm:ss[.SSS]` or `sssss[.SSS]`. Value range: `[00:00:00.000, 23:59:59.999]` or `[0.000, 86399.999]`. Example: `00:01:59.999` or `180.30`.	50
ConfigToClipFirstPart	string	Specifies whether to clip the first segment before concatenation. `true`: The system clips the first segment before concatenation and transcoding. `false`: The system first concatenates and transcodes the segments, and then clips the resulting video. Default value: `false`.	false
Watermarks	array	A list of watermark settings to overlay on the video. If specified, these settings override the corresponding parameters in the specified watermark template. You can add a maximum of four watermarks per transcoding job.
	object	Settings for a single watermark.
Type	string	The type of the watermark. `Text`: A text watermark. You must also set the text watermark parameters. `Image`: An image watermark. You must also set the image watermark parameters. Default value: The system automatically determines the type based on the watermark template.	Image
TemplateId	string	The ID of the watermark template.	962e1332fa2d4e12bdfb76dd1402fcfa
X	string	The horizontal offset of the watermark relative to the output video. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways: As an integer, representing the offset in pixels. Unit: pixels. Value range: [8, 4096]. As a decimal, representing the ratio of the offset to the width of the output video. Value range: (0, 1). Supports up to four decimal places, such as `0.9999`. The system truncates additional digits.	0.08
Y	string	The vertical offset of the watermark relative to the output video. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways: As an integer, representing the offset in pixels. Unit: pixels. Value range: [8, 4096]. As a decimal, representing the ratio of the offset to the height of the output video. Value range: (0, 1). Supports up to four decimal places, such as `0.9999`. The system truncates additional digits.	0.08
Width	string	The width of the watermark. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways: As an integer, representing the width in pixels. Unit: pixels. Value range: [8, 4096]. As a decimal, representing the ratio of the width to the width of the output video. Value range: (0, 1). Supports up to four decimal places, such as `0.9999`. The system truncates additional digits.	0.1
Height	string	The height of the watermark. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways: As an integer, representing the height in pixels. Unit: pixels. Value range: [8, 4096]. As a decimal, representing the ratio of the height to the height of the output video. Value range: (0, 1). Supports up to four decimal places, such as `0.9999`. The system truncates additional digits.	0.1
Content	string	The content of the text watermark.	TextWatarmark
FontName	string	The font name for the text watermark. Default value: `SimSun`.	SimSum
FontSize	string	The font size of the text watermark. Value range: (4, 120). Default value: `16`.
FontColor	string	The font color of the text watermark. Default value: `black`.	black
FontAlpha	string	The opacity of the font. Value range: (0, 1]. Default value: `1.0`.	1.0
BorderWidth	string	The border width of the text watermark. Unit: pixels. Value range: [0, 4096]. Default value: `0`.	0
BorderColor	string	The border color of the text watermark. Default value: `black`.	Black
Adaptive	string	Specifies whether the font size of the text watermark adapts to the output video resolution. `true`: The font size is adaptive. `false`: The font size is fixed. Default value: `false`.	true
Metadata	object	Specifies the metadata for the output video container format, provided as JSON key-value pairs. Example: `{"key1":"value1","key2":"value2"}`. Maximum key length: 64 characters. Maximum value length: 512 characters. You can add a maximum of four metadata key-value pairs.
	string	The value for a metadata entry. In the `Metadata` object, each key is a field name, and this string is its corresponding value.	{"AIGC": "xxx"}

object

Parameters for transcoding features.

Clip

object

Clip settings.

TimeSpan

object

The time span for the clip.

Seek

string

Specifies the start time of the clip. If this parameter is not set, the clip starts from the beginning of the video.

Format: hh:mm:ss[.SSS] or sssss[.SSS].
Value range: [00:00:00.000, 23:59:59.999] or [0.000, 86399.999].
Example: 00:01:59.999 or 180.30.

180.30

Duration

string

Specifies the duration of the clip, relative to the Seek time. By default, the clip extends to the end of the video. You can specify either Duration or End, but not both. If End is specified, Duration is ignored.

Format: hh:mm:ss[.SSS] or sssss[.SSS].
Value range: [00:00:00.000, 23:59:59.999] or [0.000, 86399.999].
Example: 00:01:59.999 or 180.30.

60.0

End

string

Specifies the end time of the clip. You can specify either End or Duration, but not both. If End is specified, Duration is ignored.

Format: hh:mm:ss[.SSS] or sssss[.SSS].
Value range: [00:00:00.000, 23:59:59.999] or [0.000, 86399.999].
Example: 00:01:59.999 or 180.30.

50

ConfigToClipFirstPart

string

Specifies whether to clip the first segment before concatenation.

true: The system clips the first segment before concatenation and transcoding.
false: The system first concatenates and transcodes the segments, and then clips the resulting video.
Default value: false.

false

Watermarks

array

A list of watermark settings to overlay on the video. If specified, these settings override the corresponding parameters in the specified watermark template.

You can add a maximum of four watermarks per transcoding job.

object

Settings for a single watermark.

Type

string

The type of the watermark.

Text: A text watermark. You must also set the text watermark parameters.
Image: An image watermark. You must also set the image watermark parameters.

Default value: The system automatically determines the type based on the watermark template.

Image

TemplateId

string

The ID of the watermark template.

962e1332fa2d4e12bdfb76dd1402fcfa

X

string

The horizontal offset of the watermark relative to the output video. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways:

As an integer, representing the offset in pixels.
- Unit: pixels.
- Value range: [8, 4096].
As a decimal, representing the ratio of the offset to the width of the output video.
- Value range: (0, 1).
- Supports up to four decimal places, such as 0.9999. The system truncates additional digits.

0.08

Y

string

The vertical offset of the watermark relative to the output video. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways:

As an integer, representing the offset in pixels.
- Unit: pixels.
- Value range: [8, 4096].
As a decimal, representing the ratio of the offset to the height of the output video.
- Value range: (0, 1).
- Supports up to four decimal places, such as 0.9999. The system truncates additional digits.

0.08

Width

string

The width of the watermark. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways:

As an integer, representing the width in pixels.
- Unit: pixels.
- Value range: [8, 4096].
As a decimal, representing the ratio of the width to the width of the output video.
- Value range: (0, 1).
- Supports up to four decimal places, such as 0.9999. The system truncates additional digits.

0.1

Height

string

The height of the watermark. If specified, this value overrides the corresponding parameter in the watermark template. You can specify the value in two ways:

As an integer, representing the height in pixels.
- Unit: pixels.
- Value range: [8, 4096].
As a decimal, representing the ratio of the height to the height of the output video.
- Value range: (0, 1).
- Supports up to four decimal places, such as 0.9999. The system truncates additional digits.

0.1

Content

string

The content of the text watermark.

TextWatarmark

FontName

string

The font name for the text watermark.

Default value: SimSun.

SimSum

FontSize

string

The font size of the text watermark.

Value range: (4, 120).
Default value: 16.

FontColor

string

The font color of the text watermark.

Default value: black.

black

FontAlpha

string

The opacity of the font.

Value range: (0, 1].
Default value: 1.0.

1.0

BorderWidth

string

The border width of the text watermark.

Unit: pixels.
Value range: [0, 4096].
Default value: 0.

0

BorderColor

string

The border color of the text watermark.

Default value: black.

Black

Adaptive

string

Specifies whether the font size of the text watermark adapts to the output video resolution.

true: The font size is adaptive.
false: The font size is fixed.
Default value: false.

true

Metadata

object

Specifies the metadata for the output video container format, provided as JSON key-value pairs. Example: {"key1":"value1","key2":"value2"}.

Maximum key length: 64 characters.
Maximum value length: 512 characters.

You can add a maximum of four metadata key-value pairs.

string

The value for a metadata entry. In the Metadata object, each key is a field name, and this string is its corresponding value.

{"AIGC": "xxx"}