You need to enable JavaScript to run this app.
导航

视频剪辑参数

最近更新时间2024.01.24 19:20:08

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

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

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

注意事项

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

    说明

    Track 数组中 Type 参数取值为 videoimage 类型时,支持放在同一个轨道上。

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

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。当 Alphatrue 时,VideoCodec 默认采用 VP9,而不再关注您设置的 VideoCodec 参数。

Format

String

输出视频的封装格式。取值如下:

  • (默认)mp4
  • hls

说明

  • Format 的优先级高于 VideoCodec
  • Format 设为 hls 时,表示以 HLS 格式输出视频,此时 VideoCodec 仅支持设为 h264h265
FpsFloat输出视频的帧率。单位为 fps。默认值为 30。
CodecJSON音视频编码参数设置。详见 Codec

DisableVideo

Boolean

是否仅输出音频:

  • false: (默认)输出音视频。
  • true: 仅输出音频。

说明

DisableVideoDisableAudio 同时设为 false 时,最终输出一个完整的音视频文件。

DisableAudio

Boolean

是否仅输出视频:

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

CanvasWithMax

Boolean

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

说明

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

Codec

参数类型是否必选描述

VideoCodec

String

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

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

Crf

Integer

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

说明

仅当 VideoCodec 设为 h264h265 时生效。

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]。

注意

此参数仅当 CanvasWithRatiotrue 时生效。

Short

Integer

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

注意

  • 此参数仅当 CanvasWithRatiotrue 时生效。
  • 同时设置短边和长边时,短边的优先级高于长边。

Index

String

设置输出视频画布的屏幕方向(横屏还是竖屏)与哪个资源保持一致。默认值为 0|0,即对齐第 0 个 Track 的第 0 个 Element。

注意

此参数仅当 CanvasWithRatiotrue 时生效。

Ratio

String

输出视频画布的长短边比,默认值为 16:9

注意

此参数仅当 CanvasWithRatiotrue 时生效。

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******"

  • HTTP 或 HTTPS 地址。示例值:"https://dev-material-library.****.com/creative-factory/xiaohong/****.mp3"

说明

  • 使用 HTTP 或 HTTPS 地址时,会产生公网的带宽或者流量费用。
  • 如果是点播的资源,推荐使用 Vid 的方式,系统会通过内网拉取资源,不会产生额外的带宽或流量费用。

Video

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

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

Source

String

资源下载地址。

  • 点播 Vid:vid://${vid}。示例值:"vid://v02b6d970000bvg5pi6******"

  • HTTP 或 HTTPS 地址。示例值:"https://dev-material-library.****.com/creative-factory/xiaohong/****.mp4"

说明

  • 使用 HTTP 或 HTTPS 地址时,会产生公网的带宽或者流量费用。
  • 如果是点播的资源,推荐使用 Vid 的方式,系统会通过内网拉取资源,不会产生额外的带宽或流量费用。

Image

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

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

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 基准是 TransformFilterWidth 大小。
    • 如果 Typesetting 参数取值为 1 基准是 TransformFilterHeight 大小。

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文字入场动画 IDAnimInResAnimInDuration 需同时设置。
AnimInDurationInteger文字入场动画时长。单位为毫秒。
AnimOutResString文字出场动画 IDAnimOutResAnimOutDuration 需同时设置。
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 索引来指定。

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

    {
        "Height": "$0|0.h",
        "Width": "$0|0.w"
    }
    
  • 以下示例代码表示 HeightWidth 与资源中的最大分辨率保持一致。

    {
        "Height": "$MAX.h",
        "Width": "$MAX.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