You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /
  • 视频点播

视频剪辑参数

最近更新时间：2024.04.17 17:19:56

首次发布时间：2022.03.03 12:45:34

我的收藏

本文介绍视频剪辑参数 EditParam 。视频剪辑参数的总体结构可分为以下 4 段：

  • 业务上传设置
  • 编码输出设置
  • 渲染画布设置
  • 轨道列表

注意事项

  • 不同类型的 Element 应该分别放置在不同的轨道上。

    说明

    当 Track 数组中 Type 参数取值为 video 和 image 类型时，支持放在同一个轨道上。

  • 同轨道的 Element 时间上不应该重叠，如果需要，应该通过添加更多的轨道来实现。

  • 如果使用的资源下载地址 Source 为挂载 TOS，您需要在点播控制台完成对象存储服务授权，具体操作详见点播挂载 TOS。

EditParam

参数类型是否必选描述
UploadJSON是业务上传设置，详见 UploadInfo。
OutputJSON是编码输出设置，详见 Output。
CanvasJSON否渲染画布设置，详见 Canvas。
TrackArray of JSON是轨道列表，详见 Track。

UploadInfo

参数类型是否必选描述
SpaceNameString是任务产物的上传空间。任务完成后输出的产物会被上传至此空间。示例值："edit"。

VideoName

String

否

任务产物在点播空间中的名称。支持字符：中文、 字母、数字、下划线、英文冒号、-、英文括号、中文括号、空格等。最大不超过 2048 字节。示例值："video_edit"。

说明

如果您没有设置 VideoName，点播空间中产物名称为空。

FileNameString否任务产物的文件路径。示例值："Project/VideoFiles/123.mp4"。不传的话，默认回调内容里的 FileName 参数为空。

Output

参数类型是否必选描述

Alpha

Boolean

否

输出视频中是否包含 alpha 通道。默认值为 false。

说明

Alpha 的优先级高于 VideoCodec。当 Alpha 为 true 时，VideoCodec 默认采用 VP9，而不再关注您设置的 VideoCodec 参数。

Format

String

否

输出文件的封装格式。取值如下：

  • （默认）mp4
  • hls
  • mp3

说明

  • Format 的优先级高于 VideoCodec。
  • 当 Format 设为 hls 时，表示以 HLS 格式输出视频，此时 VideoCodec 仅支持设为 h264 和 h265。
  • 当 DisableVideo 参数取值为 true 时，Format 取值为 mp3 才生效，表示 MP3 音频导出专用格式。
FpsFloat否输出视频的帧率。单位为 fps。默认值为 30。
CodecJSON否音视频编码参数设置。详见 Codec。

DisableVideo

Boolean

否

是否仅输出音频：

  • false: （默认）输出音视频。
  • true: 仅输出音频。

说明

DisableVideo 和 DisableAudio 同时设为 false 时，最终输出一个完整的音视频文件。

DisableAudio

Boolean

否

是否仅输出视频：

  • false: （默认）输出音视频。
  • true: 仅输出视频。
CoverJSON否抽帧抽封面设置。详见 Cover。

CanvasWithMax

Boolean

否

画布分辨率是否遵循最大分辨率。默认为 false。如设为 true，画布分辨率与资源中的最大分辨率保持一致。

说明

  • 最大分辨率是指宽*高的值在所有资源中最大。
  • 画布分辨率相关参数的优先级按以下顺序递减：
    1. Int 型的 Canvas.Width 和 Canvas.Height
    2. CanvasWithMax
    3. CanvaswithRatio
    4. String 型的 Canvas.Width 和 Canvas.Height
CanvasWithRatioBoolean否画布分辨率是否遵循长短边比。默认为 false。如设为 true，画布分辨率保持固定的长短边比。长短边比默认为 16:9。您也可以通过 Canvas 中的 Long、Short、Ratio 参数设置长、短边以及长短边比。
AudioPhaseDetectBoolean否是否进行音频反相检测。默认关闭。当片源时长较长时，该操作较为耗时。

Codec

参数类型是否必选描述

VideoCodec

String

否

视频编码格式。取值如下：

  • h264: （默认）H.264
  • vp9: VP9
  • h265: H.265
PresetString否用于调节视频编码速度和质量。默认值为 medium。仅当 VideoCodec 设为 h264、h265 时生效。

Crf

Integer

否

恒定质量因子 CRF。默认值为 23。

说明

仅当 VideoCodec 设为 h264、h265 时生效。

VideoBitRateInteger否视频编码码率。单位为 bps。该参数如不设置，视频编码码率通过 Crf 控制。设置该参数后，Crf 设置不生效。
AudioCodecString否音频编码格式。默认值 aac。支持的取值有 aac。
AudioBitrateInteger否音频编码码率。默认值为 128。单位为 kbps。

Cover

参数类型是否必选描述

DisableCover

Boolean

否

是否禁用封面抽帧合成：

  • false: （默认）保存封面。
  • true: 禁用封面。
CoverTimeArray of Integer否抽帧时间点。单位为毫秒。视频剪辑服务会截取所设时间点的视频帧，保存为图片文件。

Format

String

否

封面输出格式。默认值为 png。取值如下：

  • jpeg: JPEG 格式。
  • png: PNG 格式。

Canvas

参数类型是否必选描述

Width

Integer ｜ String

否

输出视频的宽。单位为 pixel，默认值为 720。取值范围为 [160,8192]。

说明

Canvas 还支持通过表达式来自动匹配某个 Element 的宽和高。具体请见通过表达式指定画布宽高。

HeightInteger ｜ String否输出视频的高。单位为 pixel，默认值为 1280。取值范围为 [160,8192]。
BackgroundColorString否画布颜色。RGBA 类型，默认值为 "#00000000"。示例值："#FF0000FF"

Long

Integer

否

输出视频画布的长边。单位为 pixel，默认值为 1280。取值范围为 [160,8192]。

注意

此参数仅当 CanvasWithRatio 为 true 时生效。

Short

Integer

否

输出视频画布的短边。单位为 pixel，默认值为 720。取值范围为 [160,8192]。

注意

  • 此参数仅当 CanvasWithRatio 为 true 时生效。
  • 同时设置短边和长边时，短边的优先级高于长边。

Index

String

否

设置输出视频画布的屏幕方向（横屏还是竖屏）与哪个资源保持一致。默认值为 0|0，即对齐第 0 个 Track 的第 0 个 Element。
当 Index 指定为 MAX 时，则表示跟随基准分辨率，也就是与资源中的最大分辨率保持一致。

注意

此参数仅当 CanvasWithRatio 为 true 时生效。

Ratio

String

否

输出视频画布的长短边比，默认值为 16:9。
当 Ratio 设置为 -1:-1 或者 -1，则表示跟随指定输入源。

注意

此参数仅当 CanvasWithRatio 为 true 时生效。

Track

Track 为视频轨道列表。Track[0] 为最底层的轨道，轨道依次叠加渲染。每个 Track 中可同时添加多个 Element 资源。Element 资源支持 5 种类型：audio、video、image、text、effect。每个 Element 资源中可以通过 Extra 字段添加多个 filter 类型资源。

下表为通用 Element 结构。

参数类型是否必选描述

Type

String

是

资源类型。取值如下：

  • audio: 音频资源
  • video: 视频资源
  • image: 图片资源
  • text: 文字资源
  • effect: 特效资源
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON否拓展资源。您可以在 Extra 中添加 filter 类型的资源。

说明

TargetTime 字段在不同数据结构中，含义不同：

  • 在轨道中时，TargetTime 为资源的轨道时间点。
  • 在 Extra 内部时，TargetTime 的时间是相对主资源的时间点。

Audio

下表为音频资源的参数介绍。

参数类型是否必选描述
TypeString是资源类型。对于音频资源，值为 audio。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON否拓展资源。

Source

String

是

资源下载地址。

  • 点播 Vid：vid://${vid}。示例值："vid://v02b6d970000bvg5pi6******"
  • 点播 DirectUrl：directurl://{fileName}。示例值：directurl://test.mp3
  • 挂载 TOS：tos://{bucketName}/{fileName}。示例值：tos://example/test.mp3

Video

下表为视频资源的参数介绍。

参数类型是否必选描述
TypeString是资源类型。对于视频资源，值为 video。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON否拓展资源。您可以在 Extra 字段传入 TransformFilter 配置资源在输出视频画布上的布局。如果不传 TransformFilter，则会按 Canvas 进行填充。

Source

String

是

资源下载地址。

  • 点播 Vid：vid://${vid}。示例值："vid://v02b6d970000bvg5pi6******"
  • 点播 DirectUrl：directurl://{fileName}。示例值：directurl://0.ts
  • 挂载 TOS：tos://{bucketName}/{fileName}。示例值：tos://example/0.ts

Image

下表为图片资源的参数介绍。

参数类型是否必选描述
TypeString是资源类型。对于图片资源，值为 image。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON否拓展资源。您可以在 Extra 字段传入 TransformFilter 配置资源在输出视频画布上的布局。如果不传 TransformFilter，则会按 Canvas 进行填充。
SourceString是资源下载地址。挂载 TOS：tos://{bucketName}/{fileName}。示例值：tos://example/0.jpg

Text

下表为文字资源和字幕资源的参数介绍。

参数类型是否必选描述

Type

String

是

资源类型。

  • 对于文字资源，值为 text。
  • 对于字幕资源，值为 subtitle。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON是拓展资源。您必须在 Extra 字段传入 TransformFilter 配置资源在输出视频画布上的布局，其他 filter 非必传。
TextString是文本内容。
TextResString否花字 ID。
FontTypeString否字体 ID。默认字体为方正雅宋。
FontSizeInteger否字体大小。如果使用默认字体，则默认字体大小为 200。

FontColor

String

否

字体颜色。RGBA 类型。如果没有使用花字，颜色默认为白色。示例值："#FF0000FF"

说明

只支持基础文字，不支持花字。

BackgroundColor

String

否

字体背景颜色。RGBA 类型。默认值为 "#00000000"。示例值："#FF0000FF"

说明

  • 仅覆盖文字，如果是多行文字，则以最长的一行为准。
  • 只支持基础文字，不支持花字。
BackgroundBorderSizeFloat否字体背景边框大小。默认值为 0。背景颜色仅仅跟随文字。

BorderColor

String

否

字体描边颜色。RGBA 类型。默认值为 "#00000000"。示例值："#FF0000FF"

说明

只支持基础文字，不支持花字。

BorderWidthInteger否字体描边宽度。最小值为 1。最大值不能超过 FontSize 的 0.1 倍。

LineMaxWidth

Float

否

自动换行宽度。取值如下：

  • -1（默认）代表不自动换行。
  • 0 ～ 1 代表自动换行。
    • 如果 Typesetting 参数取值为 0 基准是 TransformFilter 的 Width 大小。
    • 如果 Typesetting 参数取值为 1 基准是 TransformFilter 的 Height 大小。

Typesetting

Float

否

文字排列方向：

  • 0: （默认）文字横排。
  • 1: 文字竖排。

AlignType

Float

否

文本对齐方式。需要和 Typesetting 参数配合使用。

  • 当文字横排时，文本对齐方式支持设为：

    • 0: 左对齐。

    • 1: 居中对齐。

    • 2: 右对齐。

  • 当文字竖排时，文本对齐方式支持设为：

    • 1: 居中对齐。

    • 3: 上对齐。

    • 4: 下对齐。

Effect

下表为特效资源的参数介绍。

参数类型是否必选描述
TypeString是资源类型。对于特效资源，值为 effect。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
ExtraArray of JSON否拓展资源。只支持添加一种特效。可以支持的 filter 有 LutFilter、EffectFIlter。

Filter

Filter 类型资源可被添加至其它类型资源的 Extra 字段中使用。

LutFilter

LutFilter 可被添加至 Video、Image、Effect 资源的 Extra 字段中使用，用于添加滤镜。

下表为 LutFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 lut_filter。

TargetTime

Array of Integer

是

资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。

此参数在 Effect Element 中无效。

SourceString是滤镜 ID。
IntensityFloat否滤镜强度。默认值为 1。取值范围为 [0,1]

EffectFilter

EffectFilter 可被添加至 Video、Image、Effect 资源的 Extra 字段中使用，用于添加特效。

下表为 EffectFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 effect_filter。

TargetTime

Array of Integer

是

资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。

此参数在 Effect Element 中无效。

SourceString是特效 ID。

TransitionFilter

TransitionFilter 可以添加到 Video 资源的 Extra 字段中使用，用于添加转场效果。同轨道相邻 A 视频与 B 视频转场，TransitionFilter 只需要添加到 A 视频。

下表为 TransitionFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值 transition。
SourceString是转场 ID。
DurationInteger是转场时长，单位为毫秒。

TransformFilter

TransformFilter 可被添加至 Video、Image、Sticker、Text 资源的 Extra 字段中，用于配置资源在输出视频画布上的布局。

同一个 Element 中，如果同时添加了 CropFilter 和 TransformFilter，那么会先执行 CropFilter，再执行 TransformFilter。

下表为 TransformFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值 transform。
PosXInteger是资源左上角相对于输出视频画布左上角在 X 轴上的位移，单位为 pixel。
PosYInteger是资源左上角相对于输出视频画布左上角在 Y 轴上的位移，单位为 pixel。
WidthInteger是资源在输出视频画布上的宽度，单位为 pixel。
HeightInteger是资源在输出视频画布上的高度，单位为 pixel。
RotationInteger否旋转角度，取值范围为 [-360,360]，顺时针为正。
FlipXBoolean否水平镜像翻转。
FlipYBoolean否垂直镜像翻转。
AlphaFloat否透明度，取值范围 [0,1]。0 为透明。

CropFilter

CropFilter 可被添加至 Video、Image 资源的 Extra 字段中使用，用于裁剪视频。

下表为 CropFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型，默认值 crop。
PosXInteger是裁剪区域左上角相对于原图左上角在 X 轴上的位移，单位为 pixel。
PosYInteger是裁剪区域左上角相对于原图左上角在 Y 轴上的位移，单位为 pixel。
WidthInteger是裁剪区域的宽度，单位为 pixel。
HeightInteger是裁剪区域的高度，单位为 pixel。

alt

如上图所示，假设您想要在原图上裁剪出大小为 a*b 的橙色区域，那么您需要将：

  • posx 设为 b1
  • posy 设为 a1
  • width 设为 (b2-b1)
  • height 设为 (a2-a1)

TrimFilter

TrimFilter 可被添加至 Video、Audio 资源的 Extra 字段中使用，用于截取音频或视频片段。

下表为 TrimFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 trim。
StartTimeInteger是资源开始时间。
EndTimeInteger是资源结束时间。

VideoAnimationsFilter

VideoAnimationsFilter 可被添加至 Video、Image 资源的 Extra 字段中，用于添加视频动画。

下表为 VideoAnimationsFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 video_animation。
AnimResString是视频动画 ID。
AnimStartTimeInteger是动画开始时间。单位为毫秒。
AnimEndTimeInteger是动画结束时间。单位为毫秒。
AnimLoopInteger否动画是否循环。默认值为 0。循环动画时，其他动画失效。
AnimLoopDurationInteger否循环动画时长。默认值 0。当为循环动画时，该参数必选。

TextAnimationsFilter

TextAnimationsFilter 可被添加至 Text 资源的 Extra 字段中，用于添加文字动画。

下表为文字动画的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值 text_animation。
AnimInResString否文字入场动画 ID。AnimInRes 和 AnimInDuration 需同时设置。
AnimInDurationInteger否文字入场动画时长。单位为毫秒。
AnimOutResString否文字出场动画 ID。AnimOutRes 和 AnimOutDuration 需同时设置。
AnimOutDurationInteger否文字出场动画时长。单位为毫秒。
AnimLoopResString否文字循环动画 ID。循环动画 ID 和循环动画时长需同时设置。
AnimLoopDurationInteger否循环动画时长。

注意

文字入场动画时长 AnimInDuration 加上文字出场动画时长 AnimOutDuration 要小于文字展示时长 TargetTime。

EqFilter

EqFilter 可被添加至 Video、Image 资源的 Extra 字段中使用，用于均衡画面。

下表为 EqFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值 equalizer。
TargetTimeArray of Integer是资源在轨道中的时间。单位为毫秒。格式为 [start, end]。示例值：[1000,2000]。
BrightnessInteger否亮度
ContrastInteger否对比度
SaturationInteger否饱和度
SharpenInteger否锐化
HighlightInteger否高光
TemperatureInteger否色温
ToneInteger否色调

AudioFadeFilter

AudioFadeFilter 可被添加至 Audio、Video 资源的 Extra 字段中使用，用于实现音频淡入和淡出。

下表为 AudioFadeFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 a_fade。
FadeInInteger否淡入时间，单位为毫秒。假设设为 2000，那么音频前 2 秒出现音频淡入效果。
FadeOutInteger否淡出时间，单位为毫秒。假设设为 2000，那么音频后 2 秒出现音频淡出效果

AudioVolumeFilter

AudioVolumeFilter 可被添加至 Audio、Video 资源的 Extra 字段中使用，用于调节音频音量。

下表为 AudioVolumeFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值：a_volume。
VolumeFloat否音量。0 为静音，默认音量为 1。

SpeedFilter

SpeedFilter 可被添加至 Audio、Video 资源的 Extra 字段中使用，用于实现音频或视频倍速。

同一个 Element 中，如果同时添加了 TrimFilter 和 SpeedFilter，那么会先执行 TrimFilter，再执行 SpeedFilter。

下表为 SpeedFilter 的参数介绍。

参数类型是否必选描述
TypeString是资源类型。默认值为 speed。
SpeedFloat否倍速，默认值为 1，保持原速。小于 1 为慢速，大于 1 为加速。

示例

多个视频时域拼接

该示例将三个视频按时域拼接为一个视频。请求参数如下：

{
    "Uploader":"edit",
    "Application":"VideoTrackToB",
    "EditParam":{
        "Output":{

        },
        "Canvas":{
            "Width":720,
            "Height":1280
        },
        "Track":[
            [
                {
                    "Source":"vid://v02b6d970***5pi6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        0,
                        5000
                    ]
                },
                {
                    "Source":"vid://v02b6d970***5pi6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        5000,
                        10000
                    ]
                },
                {
                    "Source":"vid://v02b6d970***5pi6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        10000,
                        13000
                    ]
                }
            ]
        ],
        "Upload":{
            "SpaceName":"edit",
            "VideoName":"3"
        }
    }
}

视频多段截取合成

该示例截取了一个视频里时域在 5-15s、25-35s、50-60s、80-100s 的内容，并重新合成一个视频。请求参数如下：

{
    "Uploader":"edit",
    "Application":"VideoTrackToB",
    "EditParam":{
        "Canvas":{
            "Height":720,
            "Width":1280
        },
        "Output":{
            "Fps":25
        },
        "Track":[
            [
                {
                    "Extra":[
                        {
                            "EndTime":15000,
                            "StartTime":5000,
                            "Type":"trim"
                        }
                    ],
                    "Source":"vid://v02b6d97000***pi6vambf9r4s5qhg",
                    "TargetTime":[
                        0,
                        10000
                    ],
                    "Type":"video"
                },
                {
                    "Extra":[
                        {
                            "EndTime":35000,
                            "StartTime":25000,
                            "Type":"trim"
                        }
                    ],
                    "Source":"vid://v02b6d970000***6vambf9r4s5qhg",
                    "TargetTime":[
                        10000,
                        20000
                    ],
                    "Type":"video"
                },
                {
                    "Extra":[
                        {
                            "EndTime":60000,
                            "StartTime":50000,
                            "Type":"trim"
                        }
                    ],
                    "Source":"vid://v02b6d970000***i6vambf9r4s5qhg",
                    "TargetTime":[
                        20000,
                        30000
                    ],
                    "Type":"video"
                },
                {
                    "Extra":[
                        {
                            "EndTime":100000,
                            "StartTime":80000,
                            "Type":"trim"
                        }
                    ],
                    "Source":"vid://v02b6d97000***i6vambf9r4s5qhg",
                    "TargetTime":[
                        30000,
                        50000
                    ],
                    "Type":"video"
                }
            ]
        ],
        "Upload":{
            "SpaceName":"edit",
            "VideoName":"唐僧保我上西天"
        },
        "Uploader":"edit"
    }
}

多个视频空域拼接

该示例将三个视频按空域拼接为一个视频。

alt

请求参数如下：

{
    "Uploader":"edit",
    "Application":"VideoTrackToB",
    "EditParam":{
        "Canvas":{
            "Width":1280,
            "Height":2160
        },
        "Output":{
            "Fps":25
        },
        "Track":[
            [
                {
                    "Extra":[
                        {
                            "EndTime":15000,
                            "StartTime":5000,
                            "Type":"trim"
                        },
                        {
                            "Height":720,
                            "PosX":0,
                            "PosY":0,
                            "Type":"transform",
                            "Width":1280
                        }
                    ],
                    "Source":"vid://v02b6d970000***6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        0,
                        10000
                    ]
                }
            ],
            [
                {
                    "Extra":[
                        {
                            "EndTime":35000,
                            "StartTime":25000,
                            "Type":"trim"
                        },
                        {
                            "Height":720,
                            "PosX":0,
                            "PosY":720,
                            "Type":"transform",
                            "Width":1280
                        }
                    ],
                    "Source":"vid://v02b6d97000***pi6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        0,
                        10000
                    ]
                }
            ],
            [
                {
                    "Extra":[
                        {
                            "EndTime":60000,
                            "StartTime":50000,
                            "Type":"trim"
                        },
                        {
                            "Height":720,
                            "PosX":0,
                            "PosY":1440,
                            "Type":"transform",
                            "Width":1280
                        }
                    ],
                    "Source":"vid://v02b6d970***5pi6vambf9r4s5qhg",
                    "Type":"video",
                    "TargetTime":[
                        0,
                        10000
                    ]
                }
            ]
        ],
        "Upload":{
            "SpaceName":"edit",
            "VideoName":"唐僧保我上西天"
        }
    }
}

添加滤镜

该示例为视频添加 TransformFilter 和 LutFilter。请求参数如下：

{
    "Application":"VideoTrack",
    "Uploader":"edit",
    "EditParam":{
        "Upload":{
            "SpaceName":"edit",
            "VideoName":"编辑测试项目 2021年05月24日"
        },
        "Output":{
            "Alpha":false,
            "Fps":24.99,
            "Codec":{
                "VideoCodec":"h264",
                "Preset":"slow",
                "Crf":23,
                "AudioCodec":"aac",
                "AudioBitrate":128
            },
            "DisableVideo":false,
            "DisableAudio":true
        },
        "Track":[
            [
                {
                    "Type":"video",
                    "Source":"vid://v02b6d970***5pi6vambf9r4s5qhg",
                    "TargetTime":[
                        0,
                        4000
                    ],
                    "Extra":[
                        {
                            "Type":"transform",
                            "PosX":0,
                            "PosY":0,
                            "Width":720,
                            "Height":1280,
                            "Alpha":1
                        },
                        {
                            "Type":"lut_filter",
                            "Source":"loki://1183993",
                            "TargetTime":[
                                0,
                                4000
                            ],
                            "Intensity":1
                        }
                    ]
                }
            ]
        ],
        "Canvas":{
            "Width":720,
            "Height":1280
        }
    }
}

添加字幕文件

该示例为视频添加 SRT 字幕文件。请求参数如下：

{
    "Upload": {
        "FileName": "30000_20000.mp4",
        "SpaceName": "edit_tob",
        "VideoName": "10000_20000"
    },
    "Track": [
        [
            {
                "ID": "video0",
                "Source": "#####",
                "TargetTime": [0, 1000],
                "Extra": [],
                "Type": "video"
            }
        ],
        [
            {
                "ID": "text0",
                "TargetTime": [0, 1000],
                "Extra": [
                    {
                        "ID": "TransformFilter1",
                        "Type": "transform",
                        "PosX": 150,
                        "PosY": 1024,
                        "Width": 432,
                        "Height": 256
                    }
                ],
                "FontSize": 40,
                "FontType": "loki://1234253",
                "FontColor": "#ffcc66ff",
                "AlignType": 1,
                "Text": "http://tosv.byted.org/obj/videoarch-video-cloud-p/****.srt",
                "Type": "subtitle"
            }
        ]
    ]
}

通过表达式指定画布宽高

Canvas 支持通过表达式来自动匹配某个 Element 的宽和高。您可通过 Track 索引来指定。

  • 以下示例代码表示 Height 和 Width 取的是 Tracks[0][0] 元素（即第 0 个 Track 的第 0 个 Element）的高度和宽度值。

    {
    "Height": "$0|0.h",
    "Width": "$0|0.w"
}

分类 ID

注意

滤镜 ID、特效 ID、视频动画 ID、文字动画 ID 这几种分类 ID，目前处于众测阶段，如果有效果不符合预期，或资源兼容性问题，您可提交工单联系技术支持。

滤镜 ID

分类ID效果展示
清晰1184003
午后1184004
MUJI1184005
白皙1184006
胡桃木1184007
自然1184008
香港1183991
童年1183992
老友记1183993
迈阿密1183994
Vintage1183995
美式1183996
奶油1183961
初见1183962
鲜亮1183963
梦境1183964
济州1183965
清透1183966
日食1183951
赏味1183952
暖食1183953
可口1183954
深夜食堂1183955
樱花1183683
柠绿1183681
京都1180981
晚霞1180982
绿妍1180983
春日序1180984

转场 ID

说明

  • 不可用于非交叠转场指的是在非交叠转场中没有作用的转场效果。
  • 非交叠转场指在本元素设置转场 duration，并且本元素的 endTime 等于下一个元素的 startTime。
分类ID动画展示是否可用于非交叠转场
叶片翻转1182355否
百叶窗1182356否
风吹1182357否
交替出场1182359是
旋转放大1182360是
泛开1182358是
风车1182362是
多色混合1182363否
遮罩转场1182364否
六角形1182365是
心型打开1182366否
故障转换1182367是
飞眼1182368是
梦幻放大1182369是
开门展现1182370是
对角擦除1182371否
立方转换1182373是
透镜变换1182374是
晚霞转场1182375是
圆形打开1182376否
圆形擦开1182377否
圆形交替1182378是
时钟扫开1182379否

特效 ID

分类ID动画展示
镜像对称1199641
九分屏1188883
六分屏1188884
四分屏1188885
三分屏1188886
二分屏1188887

视频动画 ID

入场动画 ID

分类ID动画展示
圆形扫开1180355
向右滑入1180331
向左滑入1180332
向下滑入1180333
向上滑入1180334
缩小1180335
溶解显示1180336
渐显1180337
放大1180338
向右擦开1180339
向左擦开1180340
向下擦开1180341
向上擦开1180342

出场动画 ID

分类ID效果展示
圆形扫除1180375
向左滑出1180376
向右滑出1180377
向下滑出1180378alt
向上滑出1180379
缩小消失1180380
溶解消失1180381
渐隐1180382
向左擦除1180383
向右擦除1180384
向下擦除1180385
向上擦除1180386
翻转1180403

文字动画 ID

入场动画 ID

分类ID动画展示
圆形扫开1181455
溶解显示1181425
向右擦开1181426
向左擦开1181427
向下擦开1181428
向上擦开1181429
向左滑入1181430
向右滑入1181431
向下滑入1181432
向上滑入1181433
渐显1181434
放大1181435
羽化向下擦开1181436
羽化向左擦开1181437
羽化向上擦开1181438
羽化向右擦开1181439

出场动画 ID

分类ID动画展示
向右擦除1181497
向左擦除1181498
向下擦除1181499
向上擦除1181500
渐隐1181501
圆形扫除1181502
溶解消失1181503
缩小消失1181504
向右滑出1181505
向左滑出1181506
向下滑出1181507
向上划出1181508
羽化向下擦除1181509
羽化向左擦除1181510
羽化向右擦除1181511
羽化向上擦除1181512
波浪1181555
翻转1181551

循环动画 ID

分类ID效果展示
波浪1181555
翻转1181551

字体 ID

分类ID字体展示
方正兰亭大黑（繁体）1525745alt
方正新楷体1525743alt
方正硬笔楷体1525741alt
方正悠宋5061525739alt
方正悠宋5081525737alt
方正兰亭黑简体1234271alt
方正兰亭圆简体1234269alt
方正兰亭圆简体粗1234267alt
方正兰亭圆简体大1234265alt
方正兰亭圆简体特1234263alt
方正兰亭圆简体细1234259alt
方正兰亭圆简体纤1234257alt
方正兰亭圆简体中1234255alt
方正兰亭圆简体中粗1234253alt
方正兰亭圆简体准1234251alt
方正综艺体1234249alt

站酷意大利体

1187225

alt

注意

该字体不支持中文。

站酷仓耳渔阳体1187223alt
站酷高端黑1187221alt
站酷酷黑体1187219alt
站酷快乐体1187217alt
站酷文艺体1187213alt
站酷小薇 LOGO 体1187211alt

花字 ID

分类ID花字展示
黄紫立体1179433alt
黄白突出1179434alt
落日1179435alt
彩虹1179436alt
橙环1179437alt
字节跳动1179438alt
蓝色阴影泛光1179439alt
蓝色泛光1179441alt
银河1179442alt
渐变阴影1179444alt
绿色泛光1179445alt
基础文字1179443alt