API 文档

模板

最近更新时间:2020-09-18 09:21:54

简介

您在使用媒体处理功能时,通常需要设定一系列参数,模板的作用就是将这一系列参数组合在一起。设置模板能简化您的操作,使得您设置的参数可被复用而无需重复填写。

针对文件转码、视频截帧和视频转动图功能,您需要在数据万象创建 任务工作流 时,指定使用的模板,模板页为您提供了系统预设模板,您也可根据自身业务需求自定义模板

系统预设模板

系统预设模板是数据万象将常用的参数组合预先提供给您的模板,您可以直接使用。在创建任务或工作流时,您可根据模板名称选用此类模板。

单击模板右侧的【查看】按钮,可查看模板的详细信息。

说明:

  • 目前数据万象提供15种文件转码系统预设模板、3种视频截帧系统预设模板和18种视频转动图系统预设模板。
  • 系统预设模版只支持查看模版信息,不可编辑和删除。

文件转码系统模板

模板ID 模版名称 封装格式 视频编码格式 分辨率 视频码率 音频编码格式 音频码率
t02db40900dc1c43ad9bdbd8acec6075c5 MP4-FLU MP4 H.264 640 * 按比例缩放 512 Kbps AAC 128 Kbps
t04e1ab86554984f1aa17c062fbf6c007c MP4-SD MP4 H.264 720 * 按比例缩放 1024 Kbps AAC 128 Kbps
t02d06d8ad881648e69f9ca95b2e7e4b6a MP4-HD MP4 H.264 1280 * 按比例缩放 2000 Kbps AAC 128 Kbps
t064fb9214850f49aaac44b5561a7b0b3b MP4-FHD MP4 H.264 1920 * 按比例缩放 3500 Kbps AAC 128 Kbps
t077211ea3e0e74168b8ed921fcb2d5a6b MP4-2K MP4 H.264 2048 * 按比例缩放 4800 Kbps AAC 128 Kbps
t0c9cfaffb5055467691b85eed1242cd03 FLV-FLU FLV H.264 640 * 按比例缩放 512 Kbps AAC 128 Kbps
t0b612860a293f410785b3e672465dca38 FLV-SD FLV H.264 720 * 按比例缩放 1024 Kbps AAC 128 Kbps
t0b6a845f5e42847bd810ee9cbf337f83c FLV-HD FLV H.264 1280 *按比例缩放 2000 Kbps AAC 128 Kbps
t08571e1f229094eb79817f8474987a479 FLV-FHD FLV H.264 1920 * 按比例缩放 3500 Kbps AAC 128 Kbps
t0f52244b7f3c743eb9f9080b15e5fe2f8 FLV-2K FLV H.264 2048 * 按比例缩放 4800 Kbps AAC 128 Kbps
t06e5246d8bf694c88b16ae7512e83962a HLS-FLU M3U8 H.264 640 * 按比例缩放 512 Kbps AAC 128 Kbps
t03ed6a4e1b374429eadec266bd6859347 HLS-SD M3U8 H.264 720 * 按比例缩放 1024 Kbps AAC 128 Kbps
t0e09a9456d4124542b1f0e44d501d7182 HLS-HD M3U8 H.264 1280 * 按比例缩放 2000 Kbps AAC 128 Kbps
t088613dea8d564a9ba7e6b02cbd5de877 HLS-FHD M3U8 H.264 1920 * 按比例缩放 3500 Kbps AAC 128 Kbps
t08e7237a0975c427cabfa3d958f29aa58 HLS-2K M3U8 H.264 2048 * 按比例缩放 4800 Kbps AAC 128 Kbps

视频截帧系统模板

模板ID 模版名称 截帧开始时间点 截帧间隔 单视频最大截帧数 输出图片尺寸 输出格式
t01d40e440761448fc8c538fb8d5a5b81e snapshot_320*180_1 0 s 2 s 5 320 px * 180 px JPEG
t0a60a2bc71a4b40c7b3d7f7e8a2779a81 snapshot_640*360_2 0 s 10 s 5 640 px * 360 px JPEG
t07740e32081b44ad7a0aea03adcffd54a snapshot_1280*720_3 0 s 10 s 5 1280 px * 720 px JPEG

视频转动图系统模板

模板ID 模版名称 开始转码时间 转码时长 抽帧方式 输出动图帧率 输出动图尺寸 输出格式 输出动图质量
t04373959a69c04d47b62fd214dd13d8e9 gif_320*180_1 0 s 600 s 仅提取关键帧 自适应 320px * 180px GIF \
t0341b0ab2b8a340ff826e9cb4f3a7baea gif_320*180_2 0 s 600 s 抽帧频率 10 秒/帧 自适应(0.10 帧/秒) 320px * 180px GIF \
t046b1d8e5bdf842c6a58d8028b48eafee gif_320*180_3 0 s 600 s 抽帧频率 10 帧/秒 自适应(10 帧/秒) 320px * 180px GIF \
t0ef2077f215864c018a2fca73614ceca6 gif_640*360_4 0 s 600 s 仅提取关键帧 自适应 640px * 360px GIF \
t0d21406ca737a40869973a37a5daa349a gif_640*360_5 0 s 600 s 抽帧频率 10 秒/帧 自适应(0.10 帧/秒) 640px * 360px GIF \
t0878a9c9c1f054cb5bca68b8b06e556c2 gif_640*360_6 0 s 600 s 抽帧频率 10 帧/秒 自适应(10 帧/秒) 640px * 360px GIF \
t0dae821708cea4ba5b3e271810ac80a21 gif_1280*720_7 0 s 600 s 仅提取关键帧 自适应 1280px * 720px GIF \
t03fef67ad94d2466b9c0c89252ed72e87 gif_1280*720_8 0 s 600 s 抽帧间隔 10 秒/帧 自适应(0.10 帧/秒) 1280px * 720px GIF \
t030a64e9f9f5a4f53a9ef64bb7ce490b5 gif_1280*720_9 0 s 600 s 抽帧频率 10 帧/秒 自适应(10 帧/秒) 1280px * 720px GIF \
t03b0e9eca4fc34e2cba9da89d9c7c13a2 webp_320*180_1 0 s 60 s 仅提取关键帧 自适应 320px * 180px WEBP 75
t016fcddf6bc3c44b793e9b7b07119b4ee webp_320*180_2 0 s 600 s 抽帧间隔 10 秒/帧 自适应(0.10 帧/秒) 320px * 180px WEBP 75
t0bf1f1ce6d2404b258c0f81fbb9aaece1 webp_320*180_3 0 s 600 s 抽帧间隔 10 秒/帧 自适应(10 帧/秒) 320px * 180px WEBP 75
t098d6d3fcfd2c45309a408594a42559f6 webp_640*360_4 0 s 60 s 仅提取关键帧 自适应 640 * 360 WEBP 75
t0169a6a9c2eec4b51972eb63bafcbf08d webp_640*360_5 0 s 600 s 抽帧间隔 10 秒/帧 自适应(0.10 帧/秒) 640 * 360 WEBP 75
t0ef9ba537011e4876b8777aebc19d10a5 webp_640*360_6 0 s 600 s 抽帧间隔 10 秒/帧 自适应(10 帧/秒) 640 * 360 WEBP 75
t02743d344b5e74c579e50e9e135b432b8 webp_1280*720_7 0 s 60 s 仅提取关键帧 自适应 1280 * 720 WEBP 75
t0dd27c136ff2741538bec96981e058868 webp_1280*720_8 0 s 600 s 抽帧间隔 10 秒/帧 自适应(0.10 帧/秒) 1280 * 720 WEBP 75
t00ad05235d67a45a9a697b553052b7346 webp_1280*720_9 0 s 600 s 抽帧间隔 10 秒/帧 自适应(10 帧/秒) 1280 * 720 WEBP 75

自定义模板

若系统预设模板不能满足您的需求,您可选择自定义模板。目前您可为文件转码视频水印视频截帧视频转动图创建自定义模版。

文件转码

文件转码提供图片、文档等媒体类文件的转码能力,是文件码流转换成另一个码流的过程。通过转码,可以改变原始码流的编码格式、分辨率和码率等参数,从而适应不同终端和网络环境的播放。自定义文件转码模板可支持自定义设置模版参数。

操作步骤

  1. 登录 数据万象控制台 ,单击左侧导航栏【存储桶管理】,进入存储桶列表。
  2. 找到您需要存储视频的存储桶,并单击右侧操作栏的【管理】,然后进入相应存储桶管理页面。
  3. 单击左侧的【媒体处理】页签,然后单击上方的【模版】,即可进入模版配置页面。
  4. 单击【文件转码】>【创建转码模板】,弹出创建转码模版窗口,即可进行自定义配置。文件转码模版配置信息如下:
  5. 单击【确定】,完成模板创建。创建成功后,您可以在自定义模版列表中对新建的模版进行查看模版信息编辑删除的操作。
    说明:

    您可使用数据万象创建 任务工作流,对文件转码模板进行应用。

视频水印

视频水印基于文件转码功能,能够在文件转码过程中同步为视频添加图片或文字水印。

说明:

目前支持一次转码操作同时添加多个水印,其中控制台方式支持一次添加三个水印,API方式支持一次添加五个水印。若您有更多的水印数量需求,请 提交工单 获取支持。

操作步骤

  1. 登录 数据万象控制台 ,单击左侧导航栏【存储桶管理】,进入存储桶列表。
  2. 找到您需要存储视频的存储桶,并单击右侧操作栏的【管理】,然后进入相应存储桶管理页面。
  3. 单击左侧的【媒体处理】页签,然后单击上方的【模版】,即可进入模版配置页面。
  4. 单击【视频水印】>【创建水印模板】,弹出创建视频水印模板窗口,即可进行自定义配置。视频水印模版配置信息如下:

统一参数

  • 模板名称:长度不超过64字符,仅支持中文、英文、数字、_、-和*。
  • 水印类别:您可选择图片水印或文字水印。
  • 基准位置:可选择 TopRight、TopLeft、BottomRight、BottomLeft,分别对应视频左上顶点、右上顶点、左下顶点、右下顶点。
  • 偏移方式:水印偏移方式设置基于基准位置,可选择按比例或固定位置。
    • 按比例:可按宽或高设置百分比,取值范围[0, 100]。如下图所示,假设设置水平偏移比例为 a,垂直偏移比例为 b,则水平偏移 Dx = W * a,垂直偏移 Dy = H * b,其中W、H分别为视频的宽度和高度。
    • 固定位置:取值范围为[0,4096],单位 px 。如图所示,水平偏移对应为Dx,垂直偏移对应为Dy。
  • 水印时长:您可选择水印覆盖时长与视频时长一致或指定水印时长。其中指定水印时长可设置水印开始时间和水印结束时间,若只设定开始时间则默认覆盖至视频结束。

图片水印参数

  • 图片选择:若您选择图片水印,则需选择水印来源。目前支持选择同一存储桶中的水印图片,或上传
  • 水印尺寸
    • 按原图尺寸:保持水印原图尺寸,不做处理。注意若水印图大于视频画面尺寸,可能无法完全显示水印。
    • 按比例:可按宽或高设置百分比,取值范围 [1, 100]。您可只设置宽或高其一,未设定维度将等比例缩放。假设设置宽度比例为 a,高度比例为 b,则水印宽度 w = W * a,水印高度 h = H * b,其中W、H分别为视频的宽度和高度。
    • 固定大小:您可指定水印宽高,取值范围为 [1,4096],单位为 px。
  • 透明度:取值范围为[1,100],单位为%。

文字水印参数

  • 文字水印内容:长度不超过64个字符,仅支持中文、英文、数字、_、-和*。
  • 字体大小:取值范围为[5 100],单位为px。
  • 字体类型:目前中英文混合水印支持选择仿宋、黑体、楷体、宋体、华文黑体、华文黑体中、幼圆;纯英文水印支持选择ariblk、arial、ahronbd、Helvetica、HelveticaNeue。注意纯英文字体仅支持输入英文,若水印包含中文则会出现乱码。
  • 字体颜色:格式为0xRRGGBB。
  • 透明度:取值范围为[1,100],单位为%。

水印位置、尺寸示例说明:

  1. 单击【确定】,完成模板创建。创建成功后,您可以在自定义模版列表中对新建的模版进行预览查看编辑删除的操作。点击预览可查看水印在三种常用分辨率视频中的位置和大小,便于您快速调整模板。
    说明:

    您可使用数据万象创建文件转码 任务工作流,对视频水印模板进行应用。

视频截帧

视频截帧是数据万象提供的视频某一时间节点的截图功能,输出的截图统一为 jpeg 格式。自定义视频截帧模板可支持自定义设置模版名称、截帧开始时间点、截帧间隔、截帧数量、输出图片尺寸、输出格式。

操作步骤

  1. 登录 数据万象控制台 ,单击左侧导航栏【存储桶管理】,进入存储桶列表。
  2. 找到您需要存储视频的存储桶,并单击右侧操作栏的【管理】,然后进入相应存储桶管理页面。
  3. 单击左侧的【媒体处理】页签,然后单击上方的【模版】,即可进入模版配置页面。
  4. 单击【视频截帧】>【创建截帧模板】,弹出创建截帧模板窗口,即可进行自定义配置。视频截帧模版配置信息如下:
    • 模板名称:长度不超过64字符,仅支持中文、英文、数字、下划线_、中划线-*
    • 截帧开始时间点:您可选择视频总时长范围内的任意节点作为截帧开始时间点。
    • 截帧方式
      • 默认截取每帧:将视频的每一帧截图。
      • 自定义截帧间隔:从截帧开始时间点到视频结束,按照设定的时间间隔,每隔一段时间输出一张截帧图片。
      • 平均截帧:按照您设定的【截帧数量】,从截帧开始时间点到视频结束,按平均间隔截取图片。
    • 单视频最大截帧数:当您选择截帧方式为【默认截取每帧】或【自定义截帧间隔】时,需设定单视频最大的截帧数量。
    • 截帧数量:当您选择截帧方式为【平均截帧】时,需设定截帧数量。平均截帧将按照您设定的截帧数量,从截帧开始时间点到视频结束,按平均间隔截取图片。
    • 输出图片尺寸:默认输出截图尺寸为原视频图片尺寸;若您选择自定义图片大小,注意输入宽高为128-4096之间的整数。
  5. 单击【确定】,完成模板创建。创建成功后,您可以在自定义模版列表中对新建的模版进行查看编辑删除的操作。点击预览可查看水印在三种常用分辨率视频中的位置和大小,便于您快速调整模板。
    说明:

    您可使用数据万象创建 任务工作流,对视频截帧模板进行应用。

视频转动图

您可利用视频转动图功能将视频格式转为动图格式。自定义视频转动图模板可支持自定义设置模版名称、开始转码时间、转码时长、抽帧方式、输出动图帧率、输出动图尺寸、输出格式。

操作步骤

  1. 登录 数据万象控制台 ,单击左侧导航栏【存储桶管理】,进入存储桶列表。
  2. 找到您需要存储视频的存储桶,并单击右侧操作栏的【管理】,然后进入相应存储桶管理页面。
  3. 单击左侧的【媒体处理】页签,然后单击上方的【模版】,即可进入模版配置页面。
  4. 单击【视频转动图】>【创建转动图模板】,弹出创建转动图模板窗口,即可进行自定义配置。视频转动图模版配置信息如下:
    • 模板名称:长度不超过64字符,仅支持中文、英文、数字、下划线_、中划线-*
    • 开始转码时间:您可选择视频总时长范围内的任意节点作为转码开始时间点。
    • 转码时长:转码时长指【开始转码时间】之后的转码时间长度,提供【原视频时长】和【自定义】两种时长选择。
    • 抽帧方式
      • 抽取全部帧:抽取视频的每一帧。
      • 抽帧频率:您可设定每秒钟抽取帧的数量,可输入1-50内的整数。
      • 抽帧间隔:每隔指定秒数抽取1帧。
      • 仅提取关键帧:通过对视频内容的理解,利用 AI 智能识别抽取最优帧组合输出为动图。
    • 输出动图帧率:【自适应】指系统根据您所选的上述参数,自动选择适合的帧率;您也可【自定义播放帧率】,帧率限定在每秒钟1~60帧之间。
    • 输出动图格式:输出动图默认为 GIF 格式;若您选择输出动图为 WEBP 格式,则需选择输出动图的质量(1~99之间,默认为75)。
    • 输出动图尺寸:默认输出动图尺寸为原视频尺寸;若您选择自定义宽高,注意输入宽高为128-4096之间的整数。
  5. 单击【确定】,完成模板创建。创建成功后,您可以在自定义模版列表中对新建的模版进行查看模版信息编辑删除的操作。
    说明:

    您可使用数据万象创建 任务工作流,对视频转动图模板进行应用。

目录