全部产品
Search
文档中心

智能媒体服务:MediaConvertJobFeature

更新时间:Aug 27, 2026

名称

类型

描述

示例值

object

转码功能参数。

Clip

object

剪辑片段。

TimeSpan

object

剪辑时间区间。

Seek

string

开始时间点。可以设置剪辑的开始时间点。默认从开头截取。

  • 格式:hh:mm:ss[.SSS]或 sssss[.SSS]。

  • 值范围:[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

  • 示例:00:01:59.999 或 180.30。

180.30

Duration

string

持续时长。可以设置相对于开始时间点(Seek)的剪辑时长。默认从开始时间点(Seek)到结尾的全部内容。Duration 和 End 参数只支持二选一,设置 End 则 Duration 失效。

  • 格式:hh:mm:ss[.SSS]或 sssss[.SSS]。

  • 值范围:[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

  • 示例:00:01:59.99 或 180.30。

60.0

End

string

截尾时长,表示切掉尾部的若干时长。Duration 和 End 参数只支持二选一,设置 End 则 Duration 失效。

  • 格式:hh:mm:ss[.SSS]或 sssss[.SSS]。

  • 值范围:[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

  • 示例:00:01:59.999 或 180.30。

50

ConfigToClipFirstPart

string

是否对第一个剪辑片段进行剪辑。

  • true:先剪辑第一个片段,再拼接(转码)。

  • false:先拼接(转码),再剪辑。

  • 默认值:false。

false

Watermarks

array

水印列表,将图片或文字压制到画面中。如设置则覆盖指定水印模板中的对应参数。

  • 一次转码任务最多添加 4 个水印。

object

水印设置。

Type

string

水印类型。

  • Text:文字水印。此时必须设置文字水印相关参数。

  • Image:图片水印。此时必须设置图片水印相关参数。

默认值:自动识别水印模板类型。

Image

TemplateId

string

水印模板 ID。

962e1332fa2d4e12bdfb76dd1402fcfa

X

string

图片水印相对输出视频的水平偏移量。如设置则覆盖指定水印模板中的对应参数。有两种设置方式:

  • 整数型,代表偏移像素。
    • 单位:px。

    • 值范围:[8,4096]。

  • 小数型,代表水平偏移量与输出分辨率宽的比率。
    • 值范围:(0,1)。

    • 支持 4 位小数,如 0.9999,超出部分自动丢弃。

0.08

Y

string

图片水印相对输出视频的垂直偏移量。如设置则覆盖指定水印模板中的对应参数。有两种设置方式:

  • 整数型,代表偏移像素。
    • 单位:px。

    • 值范围:[8,4096]。

  • 小数型,代表水平偏移量与输出分辨率宽的比率。
    • 值范围:(0,1)。

    • 支持 4 位小数,如 0.9999,超出部分自动丢弃。

0.08

Width

string

图片水印宽度。如设置则覆盖指定水印模板中的对应参数。有两种设置方式:

  • 整数型,代表偏移像素。
    • 单位:px。

    • 值范围:[8,4096]。

  • 小数型,代表水平偏移量与输出分辨率宽的比率。
    • 值范围:(0,1)。

    • 支持 4 位小数,如 0.9999,超出部分自动丢弃。

0.1

Height

string

图片水印高度。如设置则覆盖指定水印模板中的对应参数。有两种设置方式:

  • 整数型,代表偏移像素。
    • 单位:px。

    • 值范围:[8,4096]。

  • 小数型,代表水平偏移量与输出分辨率宽的比率。
    • 值范围:(0,1)。

    • 支持 4 位小数,如 0.9999,超出部分自动丢弃。

0.1

Content

string

文字水印内容。

TextWatarmark

FontName

string

文字水印的字体名称。

  • 默认值:SimSum。

SimSum

FontSize

string

文字水印字号。

  • 值范围:(4,120)。

  • 默认值:16。

FontColor

string

文字水印字体颜色。

  • 默认值:black。

black

FontAlpha

string

字体透明度。

  • 值范围:(0,1]。

  • 默认值:1.0。

1.0

BorderWidth

string

文字水印描边宽度。

  • 单位:px。

  • 值范围:[0,4096]。

  • 默认值:0。

0

BorderColor

string

文字水印描边颜色。

  • 默认值:Black。

Black

Adaptive

string

文字水印字号是否适配输出视频大小。

  • true:是

  • false:否

  • 默认值:false

true

Metadata

object

用于指定输出视频封装格式的 metadata,格式为 JSON 键值对,示例: {"key1":"value1","key2":"value2"}。

  • key 最大长度为 64。

  • value 最大长度为 512。

最多支持添加 4 个 metadata 键值对。

string

向量数据的元信息,为 MAP 格式的 JSON 字符串。其中 key 代表字段名,value 代表数据类型。

{"AIGC": "xxx"}