助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
工作流
应用
发布
模型
多人协作
开发工具
推广与变现

视频剪辑工具插件

更新于: 2026-06-24 15:44:40

视频剪辑工具插件主要用于视频剪辑操作,包括为视频添加字幕、音视频合成、视频拼接、音频和图片合成视频、视频插帧处理、视频超分辨率处理等功能。

说明

视频剪辑工具插件 QPS 限额为 1,即包括子用户在内的每个用户 1 秒内最多只能调用 1 次。

计费说明

视频剪辑工具插件的计费方式为基准计费项✖️抵扣系数✖️时长(分钟),具体的计费项、单价及免费额度,请参考插件费用
不同工具输出不同分辨率的视频或音频时,对应的抵扣系数不同,抵扣系数列表如下。
例如调用 image_to_video 工具生成一个 90 秒视频,视频分辨率固定为 1080 P,则该工具对应的计费抵扣系数为 6,消耗的积分为 10 积分/分钟 ✖️ 6(系数) ✖️ 1.5 分钟 = 90 积分

工具

抵扣系数

add_subtitles 工具

该类工具中,不同视频输出规格对应的抵扣系数如下:

  • 4K(3840x2160)分辨率及以下:24
  • 2K(2560x1440)分辨率及以下:12
  • 1080P(1920x1080)分辨率及以下:6
  • 720P(1280x720)分辨率及以下:3
  • 540P (720x540)分辨率及以下:2
  • 480P (640x480)分辨率及以下:1.5
  • 360P(480x360)分辨率及以下:1
  • 音频:1

compile_video_audio 工具

audio_extract 工具

video_trim 工具

concat_videos 工具

compile_image_audio 工具

add_subvideo 工具

add_text 工具

image_to_video 工具

audio_mix 工具

video_speed 工具

ajust_audio_volume 工具

ajust_video_resolution 工具

video_fps 工具

video_flip 工具

audio_loudness_normalization 工具

insert_frame 工具

该类工具中,不同视频输出规格对应的抵扣系数如下:

  • 4K(3840x2160)分辨率及以下:600
  • 2K(2560x1440)分辨率及以下:300
  • 1080P(1920x1080)分辨率及以下:150
  • 720P(1280x720)分辨率及以下:75

video_super_resolution 工具

video_hdr 工具

audio_denoise 工具

audio_to_subtitle 工具

5

audio_separate 工具

7

add_subtitles 工具

add_subtitles 工具会基于视频 URL、字幕文件 URL/自定义文本、字幕样式,为视频添加字幕。配置 add_subtitles 工具时,你可以使用 subtitle_url 参数传入字幕文件 URL 为视频添加字幕,也可以使用text_list 参数传入自定义文本及对应定位信息,在指定位置精准添加字幕。你还可以配置 subtitle_config 参数,用于指定字幕样式配置,包括字体大小、字体 ID、字体颜色及字幕显示位置和尺寸等。

演示效果

Image

输入参数

输入参数说明如下表所示:

参数

说明

subtitle_config

设置字幕的样式,Object 类型,包含如下字段:

  • font_size:字幕的字体大小,Integer 类型,单位:像素。
  • font_type:字幕的字体 ID,String 类型,详情请参考字体 ID
  • font_color:字幕的字体颜色,String 类型,RGBA 格式,例如 #FFFFFFFF。
  • background_border_width:字幕背景的边框大小,Number 类型,单位:像素。
  • background_color:字幕背景的边框颜色,String 类型,RGBA 格式,例如 #FFFFFFFF。
  • border_color:字幕内容描边的颜色,String 类型,RGBA 格式,例如 #FFFFFFFF。border_width:字幕内容描边的的宽度,Integer 类型,单位:像素。
  • font_pos_config.width:字幕的宽度,支持设置为百分比(相对于视频宽度)或具体像素值,String 类型,例如 100% 或 1000。
  • font_pos_config.height:字幕的高度,支持设置为百分比(相对于视频高度)或具体像素值,String 类型,例如 10% 或 100。
  • font_pos_config.pos_x:字幕在水平方向(X 轴)的位置,以视频正上方居中位置为原点,单位:像素,String 类型。例如值为 0 时,表示字幕在水平位置居中;值为 - 100 时,表示字幕向左移动 100 像素;值为 100 时,表示字幕向右移动 100 像素。
  • font_pos_config.pos_y:水印在垂直方向(Y 轴)的位置,以视频正上方居中位置为原点,单位:像素,String 类型。例如值为 0 时,表示字幕在视频顶部;值为 100 时,表示字幕向下移动 100 像素。

配置示例如下:

{
    "font_size": 20,
    "font_type": "1525745",
    "font_color": "#FFFFFFFF",
    "background_color":"#646464FF",
    "background_border_width":2,
    "border_color":"#646464FF",
    "border_width":2,
    "font_pos_config": {
      "width": "100%",
      "height": "100",
      "pos_x": "0",
      "pos_y": "0"
    }
  }

video

需添加字幕的视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

subtitle_url

字幕文件 URL。常见的字幕文件为 SRT、VTT、ASS 等格式。支持如下两种配置方式:

  • 固定值:直接输入字幕文件 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现字幕文件的动态输入。

text_listsubtitle_url 参数二选一配置即可。

text_list

自定义添加字幕文本,Array 类型。包含如下字段:

  • start_time:该段字幕的开始时间。
  • end_time:该段字幕的结束时间。
  • text:字幕内容。

配置示例如下:

[
    {
        "text": "今天是星期一",
        "start_time": 4.309,
        "end_time": 5.912
    },
    {
        "text": "今天是星期二",
        "start_time": 5.962,
        "end_time": 7.638
    },
    {
        "text": "今天是星期三",
        "start_time": 7.688,
        "end_time": 9.059
    }
]

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

添加字幕后的视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长。

audio_to_subtitle 工具

audio_to_subtitle 工具用于将音频转换为字幕文件。配置 audio_to_subtitle 工具时,你需要配置 source,用于输入视频或音频 URL,配置 subtitle_type 参数,用于指定输出的字幕文件的格式。

输入参数

参数

说明

source

视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

subtitle_type

生成的字幕文件类型,可选值为 webvtt、srt。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

字幕文件 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

message

执行插件时的状态描述或错误提示信息。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

compile_video_audio 工具

compile_video_audio 工具用于合成音视频,通过指定待合成的音频和视频 URL,即可轻松合成音视频。此外,该工具还提供额外的灵活配置选项,包括是否保留原视频的音频轨道,以及配置音频、视频同步功能,通过设置同步方法(加速或裁剪)和同步模式(以视频或音频时长为准)来对齐音频和视频时长,从而生成同步的视听内容。

演示效果

为原本无声的视频配上背景音乐,效果如下:

输入参数

输入参数说明如下表所示:

参数

说明

audio

待合成的音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

video

待合成的视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

is_audio_reserve

是否保留原视频流中的音频。

  • true:保留。
  • false:不保留。

is_video_audio_sync

是否对齐音频和视频时长。

  • true:通过 output_sync 配置,对齐音频和视频时长。
  • false(默认值):保持原样输出,不做音视频对齐。最终合成的视频时长,以较长的流为准。

output_sync

设置 is_video_audio_synctrue 时,须设置对齐模式,包括对齐基准和对齐方式, Object 类型,包含如下字段:

  • sync_mode:当音频和视频时长不相等时,可指定对齐基准,可选项:video、audio。
    • video:以视频的时长为准。
    • audio:以音频的时长为准。
  • sync_method:指定对齐方式,支持通过裁剪或加速的方式,对齐音频和视频的时长。可选项:speed、trim。
    • speed:通过加快音频或视频的速度,对齐音频和视频的时长。
    • trim:通过裁剪音频或视频,对齐音频和视频的时长。从头开始计算并裁剪。

示例如下:
添加如下配置,指定以视频时长为准,当音频时长超过视频时长时,裁剪音频多余部分,如果音频时长短于视频时长时,不足部分则无音频。

{
  "sync_mode":"video",
  "sync_method":"trim"
}

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

合成后的视频 URL。有效期为 1 ~ 30 天,由输入参数 url_expire 决定。请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长。

audio_separate 工具

audio_separate 工具用于分离并输出音频或视频中的人声和背景音乐。在配置 audio_separate 工具时,你需要配置 source 参数,用于输入音频或视频 URL。

输入参数

参数

说明

source

视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

background

背景音乐 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定。请及时转存。

voice

人声音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定。请及时转存。

duration

视频时长,单位:秒。

message

执行插件时的状态描述或错误提示信息。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

audio_extract 工具

audio_extract 工具用于抽取视频中的音频,并支持将其保存为指定格式的音频文件。在配置 audio_extract 工具时,你需要配置 video 参数,用于输入视频 URL,配置 format 参数,用于指定输出音频的格式。

输入参数

参数

说明

video

视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

format

输出音频的格式,支持 mp3、m4a 格式。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定。请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出音频的元数据,Object 类型,包括如下子字段:

  • resolution:固定为 unknown。
  • type:输出结果的类型,固定为 audio。
  • duration:音频的时长,单位:秒。

video_trim 工具

video_trim 工具用于裁剪视频时长,保留从指定的裁剪开始时间到结束时间范围内的视频。在配置 video_trim 工具时,你需要配置 video 参数,用于输入视频 URL,配置 start_timeend_time 参数,用于指定视频裁剪的开始时间和结束时间。

演示效果

原始视频

输出视频

输入参数

参数

说明

video

视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

end_time

裁剪结束时间,默认为片源结尾。支持设置为 2 位小数,单位:秒。
设置设置为 8,则表示在 8 秒位置结束裁剪。

start_time

裁剪开始时间,默认为 0, 表示从头开始裁剪。支持设置为 2 位小数,单位:秒。
例如设置为 2,则表示从 2 秒的位置开始裁剪。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长。

concat_videos 工具

concat_videos 工具内置多种转场效果,只需输入视频 URL 列表和对应的转场效果 ID 列表,工具即会自动按顺序拼接视频,并在各视频片段的拼接处添加指定的转场效果。在配置 concat_videos 工具时,你需要配置 videos 参数,用于输入视频的 URL,并配置 transitions 参数,用于指定视频转场。

演示效果

将两个视频合成一个视频,并添加转场,效果如下:

输入参数

输入参数说明如下表所示:

参数

说明

videos

待拼接的视频列表,Array<string> 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现音频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议总视频时长在 5 分钟以内。

transitions

转场效果 ID,Array<string> 类型,例如 ["1182359"]。concat_videos 工具支持非交叠转场的效果,详情请参考转场 ID
当视频数量超过转场数量 2 个及以上时,系统将自动循环使用转场。例如有 10 个视频,2 种转场效果,那么在 9 处拼接点上,这 2 种转场效果将被依次循环使用。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

剪辑后的视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长。

compile_image_audio 工具

compile_image_audio 工具用于将音频和图片集合成视频,该工具还提供了多种转场效果,让图片之间的衔接更自然流畅。视频的长度取决于音频长度。在配置 compile_image_audio 工具时,你需要配置 audioimages 参数,用于上传视频 URL 和图片 URL,并配置 transitions 参数,用于指定视频转场。

演示效果

基于音频和图片集生成视频,视频效果如下:

输入参数

输入参数说明如下表所示:

参数

说明

audio

音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现音频的动态输入。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

images

图片 URL,Array 类型。支持如下两种配置方式:

  • 固定值:直接输入图片 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现图片的动态输入。

图片要求:

  • 支持处理 JPEG、PNG、WebP 等常见格式的图片。

transitions

转场效果 ID,Array<string> 类型,例如 ["1182359"]。compile_image_audio 工具支持非交叠转场的效果,详情请参考转场 ID
当图片数量超过转场数量 2 个及以上时,系统将自动循环使用转场。例如有 10 张图片,2 种转场效果,那么在 9 处拼接点上,这 2 种转场效果将被依次循环使用。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长。

insert_frame 工具

insert_frame 工具基于智能算法,能够在原视频相邻帧之间生成过渡自然的新帧,使视频帧率提升至原来的 2 倍,即如果原视频为 15 FPS,经处理后可变为 30 FPS,能有效改善视频播放时的卡顿感,让画面动作更流畅连贯。在配置 insert_frame 工具时,你需要配置 video 参数,用于输入视频 URL。

演示效果

原始视频

输出视频(2倍帧率)

输入参数

输入参数说明如下表所示:

参数

说明

video

视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 视频时长需在 15 秒以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

message

执行插件时的状态描述或错误提示信息。

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率信息。
  • fps:视频的帧率,即每秒包含的帧数。
  • duration:视频的时长。

video_super_resolution 工具

video_super_resolution 工具基于深度学习方法,能够根据视频信息对其进行空域、时域建模重构出缺失的细节,将低分辨率的视频重建出高分辨率视频。在配置 video_super_resolution 工具时,你需要配置 video 参数,用于输入视频 URL,配置 resolution 参数,用于指定输出视频的分辨率。

演示效果

原始视频(分辨率 480P)

输出视频(分辨率 4K)

输入参数

输入参数说明如下表所示:

参数

说明

resolution

输出视频的分辨率,支持设置为 720P、1080P、2K、4K。

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 视频时长需在 15 秒以内。
  • 原始视频最大支持的分辨率为 1920*1080。
  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

message

执行插件时的状态描述或错误提示信息。

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • fps:视频的帧率,即每秒包含的帧数。
  • duration:视频的时长,单位:秒。

add_subvideo 工具

add_subvideo 工具用于为视频添加图片或视频水印。在配置 add_subvideo 工具时,你需要配置 video 参数,用于输入视频 URL,配置 subvideo_url 参数用于输入水印内容,配置 subvideo_config 参数,用于指定水印的样式,包括位置、大小等。其中,水印位置说明如下:
Image

演示效果

原始视频

输出视频(添加图片水印)

输入参数

参数

说明

subvideo_config

设置水印的格式,Object 类型,包含如下字段:

  • height:水印的高度,支持设置为百分比(相对于视频高度)或具体像素值,String 类型,例如 100% 或 100。
  • width:水印的宽度,支持设置为百分比(相对于视频高度)或具体像素值,String 类型,例如 100% 或 100。
  • pos_x:水印在水平方向(X 轴)的位置,以视频左上角为原点,单位:像素,String 类型。例如值为 0 时,表示水印处于水平方向的最左侧;值为 100 时,表示水印相对原点向右移动 100 像素。
  • pos_y:水印在垂直方向(Y 轴)的位置,以视频左上角为原点,单位:像素,String 类型。例如值为 0 时,表示水印在垂直方向的最上侧;值为 100 时,表示水印相对原点向下移动 100 像素。
  • start_time:水印的开始时间,Number 类型,单位:秒。
  • end_time:水印的结束时间,Number 类型,单位:秒。

说明

如果设置的水印开始时间、结束时间超出原始视频时长,那么输出视频的长度将以水印的结束时间为准,超出原始视频部分将以黑屏形式延续。例如原始视频为 20 秒,设置 end_time 为 30,那么输出时长为 30 秒。

{
  "height": "100",
  "width": "100",
  "pos_x": "100",
  "pos_y": "100",
  "start_time": 0,
  "end_time": 10
}

subvideo_url

水印图片或视频 URL。

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

add_text 工具

add_text 工具用于为视频添加文字水印。在配置 add_text 工具时,你需要配置 video 参数,用于输入视频 URL,配置 text 参数用于设置水印的内容,配置 text_config 参数,用于指定水印的样式,包括位置、大小、颜色等。其中,水印位置说明如下:
Image

演示效果

原始视频

输出视频(添加水印)

输入参数

参数

说明

text

设置水印的内容。

text_config

设置水印内容的格式、位置、颜色等属性,Object 类型,包含如下字段:

  • font_color:水印文字的颜色,RGBA 格式,例如 #FFFFFFFF,String 类型。
  • font_size:水印文字的大小,单位:像素,Integer 类型。
  • font_type:水印文字的字体类型,String 类型,详情请参考字体 ID
  • background_color:水印的背景颜色,RGBA 格式,例如 #FFFFFFFF,String 类型。
  • background_border_width:水印背景的边框宽度,Number 类型,单位:像素。
  • border_color:水印文字的描边颜色,RGBA 格式,例如 #FFFFFFFF,String 类型。
  • border_width:水印文字的描边宽度,Number 类型,单位:像素。
  • start_time:水印的开始时间,Number 类型,单位:秒。
  • end_time:水印的结束时间,Number 类型,单位:秒。
  • font_pos_config.height:水印的高度,支持设置为百分比(相对于视频高度)或具体像素值,例如 100% 或 100,String 类型。
  • font_pos_config.width:水印的宽度,支持设置为百分比(相对于视频高度)或具体像素值,例如 100% 或 100,String 类型。
  • font_pos_config.pos_x:水印在水平方向(X 轴)的位置,以视频左上角为原点,单位:像素,String 类型。例如值为 0 时,表示水印处于水平方向的最左侧;值为 100 时,表示水印相对原点向右移动 100 像素。
  • font_pos_config.pos_y:水印在垂直方向(Y 轴)的位置,以视频左上角为原点,单位:像素,String 类型。例如值为 0 时,表示水印在垂直方向的最上侧;值为 100 时,表示水印相对原点向下移动 100 像素。

说明

如果设置的水印开始时间、结束时间超出原始视频时长,那么输出视频的长度将以水印的结束时间为准,超出原始视频部分将以黑屏形式延续。例如原始视频为 20 秒,设置 end_time 为 30,那么输出时长为 30 秒。

{
    "font_color": "#FFFFFFFF",
    "font_size": 50,
    "font_type": "1525745",
    "background_color":"#646464FF",
    "background_border_width":2,
    "border_color":"#646464FF",
    "border_width":2,
    "start_time":0,
    "end_time":10,
    "font_pos_config": {
      "width": "10%",
      "height": "10%",
      "pos_x": "100",
      "pos_y": "100"
    }
  }

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。

url_timeout

输出视频 URL 的有效期。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

video_hdr 工具

video_hdr 工具基于智能算法将 SDR(标准动态范围)视频转换为 HDR (高动态范围)视频,从而提升视频的对比度、色彩丰富度,实现更好的视觉效果。在配置 video_hdr 工具时,你需要配置 video 参数,用于输入视频 URL。

演示效果

原始视频

输出视频

输入参数

参数

说明

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • fps:视频的帧率。
  • duration:视频的时长,单位:秒。

ajust_video_resolution 工具

ajust_video_resolution 工具用于将视频从高分辨率转为低分辨率,例如将 1080P 转换为 720P,用于不同场景的播放。在配置 ajust_video_resolution 工具时,你需要配置 video 参数,用于输入视频 URL。

演示效果

原始视频(4K)

输出视频(720P)

输入参数

参数

说明

resolution

设置输出视频的分辨率, 支持 360p、480p、540p、720p、1080p、2k、4k。

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

audio_mix 工具

audio_mix 工具用于对多个音频进行叠加处理,实现混音的效果。在配置 audio_mix 工具时,你需要配置 audios 参数,用于输入多个音频 URL。

输入参数

参数

说明

audios

原始音频 URL,Array 类型。输出音频的时长以最长的音频为准。

  • 固定值:直接输入多个音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出音频的元数据,Object 类型,包括如下子字段:

  • resolution:固定为 unknown。
  • type:输出结果的类型,固定为 audio。
  • duration:音频的时长,单位:秒。

video_speed 工具

video_speed 工具用于调整视频或音频的播放速度。在配置 video_speed 工具时,你需要配置 video 参数,用于输入视频 URL,配置 speed 参数用于指定速度调整的倍数。

演示效果

原始视频

输出视频(加速2倍)

输入参数

参数

说明

speed

调整速度的倍数,取值范围为 0.1~4。

  • 0.1:放慢至原速的 0.1 倍。
  • 1(默认值):原速。
  • 4:加速至原速的 4 倍。

video

原始视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频或音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频或音频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率,仅输入源为视频时生效。
  • type:输出结果的类型,audio 或 video。
  • duration:输出结果的时长,单位:秒。

ajust_audio_volume 工具

ajust_audio_volume 工具用于调整视频或音频中的音量。在配置 ajust_audio_volume 工具时,你需要配置 video 参数,用于输入视频或音频 URL,配置 volume 参数用于指定视频或音频中音量的扩大倍数。

输入参数

参数

说明

video

原始视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。
  • 包含声音。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

volume

指定音量的扩大倍数,取值范围为0~4。

  • 0:静音。
  • 1(默认值):音量不变。
  • 4:声音扩大至原来的 4 倍。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频或音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频或音频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率,仅输入源为视频时生效。
  • type:输出结果的类型,audio 或 video。
  • duration:输出结果的时长,单位:秒。

video_fps 工具

video_fps 工具用于转换视频帧率。配置 video_fps 工具时,你需要配置 video 参数,用于输入视频 URL,配置 fps 参数,用于指定视频的目标帧率。

演示效果

原始视频(帧率 24)

输出视频(帧率 60)

输入参数

参数

说明

fps

设置输出视频的帧率。
设置的帧率大于原始视频的帧率时,默认采用复制帧方式实现。

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

audio_loudness_normalization 工具

audio_loudness_normalization 工具用于均衡调整音频或视频的音量,避免音量过大过小的现象,提升播放体验。配置 audio_loudness_normalization 工具时,你需要配置 video 参数,用于输入视频或音频 URL。

输入参数

参数

说明

video

原始视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频或音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频或音频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率,仅输入源为视频时生效。
  • type:输出结果的类型,audio 或 video。
  • duration:输出结果的时长,单位:秒。

audio_denoise 工具

audio_denoise 工具用于去除视频或音频中的噪声,提升音质体验。配置 audio_denoise 工具时,你需要配置 video 参数,用于输入视频或音频 URL。

输入参数

参数

说明

video

原始视频或音频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频或音频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

音频要求:

  • 支持处理 MP3、WAV、FLAC 等常见格式的音频。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频或音频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • fps:输出视频的帧率。
  • duration:输出结果的时长,单位:秒。

说明

仅输入源为视频时,该输出参数才有效。

video_flip 工具

video_flip 工具用于对视频画面进行翻转,支持上下翻转、左右翻转。配置 video_flip 工具时,你需要配置 video 参数,用于输入视频 URL,你还可以配置 xflipyflip 参数,用于指定视频的翻转方向

演示效果

原始视频

输出视频(左右翻转)

输入参数

参数

说明

video

原始视频 URL,String 类型。支持如下两种配置方式:

  • 固定值:直接输入视频 URL。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。

视频要求:

  • 支持处理 MP4、AVI、MKV、MOV 等常见格式的视频。
  • 建议视频时长在 5 分钟以内。

xflip

是否对视频进行上下翻转。Boolean 类型。默认值为 false, 表示不翻转。

yflip

是否对视频进行左右翻转。Boolean 类型。默认值为 false, 表示不翻转。

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

输出参数说明如下表所示:

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

image_to_video 工具

image_to_video 工具用于将图片转换为视频。在配置 image_to_video 工具时,你需要配置 images 参数,用于输入图片 URL、图片播放时长和动画效果等信息。

演示效果

输入参数

[
  {
    "source": "https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7b6f8ff887f64e4bab28771e2253627f~tplv-goo7wpa0wc-image.image",
    "duration": 3,
    "animation_type": "move_up",
    "animation_in":0,
    "animation_out":2 
  }, 
  {
    "source": "https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/61f7f308f0d7411ca716767123844fc7~tplv-goo7wpa0wc-image.image",
    "duration": 3,
    "animation_type": "move_down",
     "animation_in":0,
    "animation_out":2 
  },
  {
    "source": "https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6e7d570111aa44489256a7b8591f1e30~tplv-goo7wpa0wc-image.image",
    "duration": 3,
    "animation_type": "zoom_out",
     "animation_in":0,
    "animation_out":2 
  }
]

视频

输入参数

参数

说明

images

原始图片 URL 合集。Array 类型。包含如下子字段:

  • source:原始图片 URL。
  • duration:图片播放时长,选填,默认值:3,单位:秒,支持 2 位小数。
  • animation_type:图片的动画类型,选填,不填时无动画效果。
    • move_up:向上移动
    • move_down:向下移动
    • move_left:向左移动
    • move_right:向右移动
    • zoom_in:缩小
    • zoom_out:放大
  • animation_in:动画开始时间,选填,支持2位小数。默认值:0,表示动画随图片播放同时开始,单位:秒,
  • animation_out:动画结束时间,选填,支持2位小数。默认为图片展示时长,表示动画随图片播放同时结束,单位:秒,
[
  {
    "source": "image_url01",
    "duration": 3,
    "animation_type": "move_up",
    "animation_in":0,
    "animation_out":2
  },
  {
    "source": "image_url02",
    "duration": 3,
    "animation_type": "move_down",
    "animation_in":0,
    "animation_out":2
  }
]

url_expire

设置结果 URL 的有效期。单位:秒,默认值为 86400(1 天),最长可设置为 2592000(30 天)。

输出参数

参数

说明

req_id

请求 ID。

url

输出视频 URL。URL 有效期为 1 ~ 30 天,由输入参数 url_expire 决定,请及时转存。

bill_info

计费参考信息,Object 类型,包括如下子字段:

  • duration:视频的时长,单位:秒。
  • ratio:计费的抵扣系数。

video_meta

输出视频的元数据,Object 类型,包括如下子字段:

  • resolution:视频的分辨率。
  • type:输出结果的类型,固定为 video。
  • duration:视频的时长,单位:秒。

  • 视频剪辑工具插件 ID:7514607540051640360