文档

短视频制作

更新时间:

通过配置Timeline提交剪辑合成作业时,您需要根据实际业务需求配置此参数。通过阅读本文,您可以了解短视频常用功能的Timeline示例。

属性说明

以下示例中的属性详情,请参见Timeline配置说明

Timeline示例

视频横转竖——补充上下黑边

如果Timeline中的素材为横屏视频,在调用接口SubmitMediaProducingJob提交合成任务时,通过设置参数OutputMediaConfig中的WidthHeight字段将成片视频设置为竖屏样式,系统会根据素材和成片的宽高设置将素材居中展示。

说明

如果您想自定义“黑边”颜色,需要在Effects字段中设置"SubType": "Color"。关于Effects具体参数说明,请参见Effect Type:Background 背景设置

{
 "VideoTracks": [{
 "VideoTrackClips": [{
 "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4"
 },{
 "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4"
 },{
 "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4"
 }]
 }]
}

视频横转竖——补充上下模糊区域

如果Timeline中的素材为横屏视频,在调用接口SubmitMediaProducingJob提交合成任务时,通过设置参数OutputMediaConfig中的WidthHeight字段将成片视频设置为竖屏样式,系统会根据素材和成片的宽高设置将素材居中展示,填充部分进行模糊处理。

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
   "Effects": [{
    "Type": "Background",
    "SubType": "Blur",
    "Radius": 0.1
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
   "Effects": [{
    "Type": "Background",
    "SubType": "Blur",
    "Radius": 0.1
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
   "Effects": [{
    "Type": "Background",
    "SubType": "Blur",
    "Radius": 0.1
   }]
  }]
 }]
}

视频横转竖——三分屏效果

添加三个视频轨,将横屏视频分辨放置在成片上、中、下三分之一的位置,可达到三分屏效果。

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666
    },{
      "MediaURL": "https://your-bucket****.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666
    }]
  }],
  "SubtitleTracks":[
    {
      "SubtitleTrackClips": [
        {
          "Type": "Text",
          "X": 0,
          "Y": 200,
          "Font": "AlibabaPuHuiTi",
          "Content": "这里是标题",
          "Alignment": "TopCenter",
          "FontSize": 80,
          "FontColorOpacity": 1,
          "1FontColor": "#ffffff",
          "FontColor": "#FFDEAD",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 200,
          "Font": "AlibabaPuHuiTi",
          "Content": "这里是标题",
          "Alignment": "TopCenter",
          "FontSize": 80,
          "FontColorOpacity": 1,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type":"Text",
          "X": 0,
          "Y": 320,
          "Font": "KaiTi",
          "Content": "这里是副标题",
          "Alignment": "TopCenter",
          "FontSize": 45,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": false,
            "Italic": true,
            "Underline": true
          }
        },{
          "Type":"Text",
          "X": 0,
          "Y": 900,
          "Font": "AlibabaPuHuiTi",
          "Content": "这里是横幅字幕\n可以加换行符进行多行展示",
          "Alignment": "TopCenter",
          "FontSize": 40,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    }
  ]
}

视频水平翻转、竖直翻转

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/test_media/doc_video/5.mov",
                    "Width": 0.48,
                    "Height": 0.49,
                    "X": 0,
                    "Y": 0,
                    "Effects": [
                        {
                            "Type": "Text",
                            "FixedX": 0,
                            "FixedY": 0,
                            "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                            "Content": "原视频",
                            "Alignment": "TopLeft",
                            "FontSize": 100,
                            "FontColor": "#F5FFFA",
                            "TimelineIn": 0,
                            "TimelineOut": 10,
                            "Outline": 2,
                            "OutlineColour": "#0e0100"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/test_media/doc_video/5.mov",
                    "Width": 0.48,
                    "Height": 0.49,
                    "X": 0.5,
                    "Y": 0,
                    "Effects": [
                        {
                            "Type": "Flip",
                            "Direction": "horizontal"
                        },{
                            "Type": "Text",
                            "FixedX": 0.5,
                            "FixedY": 0,
                            "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                            "Content": "视频水平翻转",
                            "Alignment": "TopLeft",
                            "FontSize": 100,
                            "FontColor": "#F5FFFA",
                            "TimelineIn": 0,
                            "TimelineOut": 10,
                            "Outline": 2,
                            "OutlineColour": "#0e0100"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/test_media/doc_video/5.mov",
                    "Width": 0.48,
                    "Height": 0.49,
                    "X": 0,
                    "Y": 0.5,
                    "Effects": [
                        {
                            "Type": "Flip",
                            "Direction": "vertical"
                        },{
                            "Type": "Text",
                            "FixedX": 0,
                            "FixedY": 0.5,
                            "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                            "Content": "视频竖直翻转",
                            "Alignment": "TopLeft",
                            "FontSize": 100,
                            "FontColor": "#F5FFFA",
                            "TimelineIn": 0,
                            "TimelineOut": 10,
                            "Outline": 2,
                            "OutlineColour": "#0e0100"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/test_media/doc_video/5.mov",
                    "Width": 0.48,
                    "Height": 0.49,
                    "X": 0.5,
                    "Y": 0.5,
                    "Effects": [
                        {
                            "Type": "Flip",
                            "Direction": "horizontal"
                        },{
                            "Type": "Flip",
                            "Direction": "vertical"
                        },{
                            "Type": "Text",
                            "FixedX": 0.5,
                            "FixedY": 0.5,
                            "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                            "Content": "视频水平竖直翻转",
                            "Alignment": "TopLeft",
                            "FontSize": 100,
                            "FontColor": "#F5FFFA",
                            "TimelineIn": 0,
                            "TimelineOut": 10,
                            "Outline": 2,
                            "OutlineColour": "#0e0100"
                        }
                    ]
                }
            ]
        }
    ]
}

添加字幕

通过配置TimelineInTimelineOut字段设置字幕的出入场时间,如果未设置,默认字幕从视频第0秒显示到视频结束,常用来设置全局字幕效果。

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4"
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4"
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4"
  }]
 }],
 "SubtitleTracks": [{
  "SubtitleTrackClips": [{
    "Type": "Text",
    "X": 0,
    "Y": 200,
    "Font": "AlibabaPuHuiTi",
    "Content": "这里是标题",
    "Alignment": "TopCenter",
    "FontSize": 80,
    "FontColorOpacity": 1,
    "FontColor": "#ffffff",
    "FontFace": {
     "Bold": true,
     "Italic": false,
     "Underline": false
    }
   },
   {
    "Type": "Text",
    "X": 0,
    "Y": 320,
    "Font": "KaiTi",
    "Content": "这里是副标题",
    "Alignment": "TopCenter",
    "FontSize": 45,
    "FontColor": "#ffffff",
    "FontFace": {
     "Bold": false,
     "Italic": true,
     "Underline": true
    }
   },
   {
    "Type": "Text",
    "X": 50,
    "Y": 740,
    "Font": "AlibabaPuHuiTi",
    "Content": "角度旋转",
    "FontColor": "#FFD700",
    "Outline": 4,
    "Angle": 350,
    "OutlineColour": "#000000",
    "FontSize": 60,
    "FontFace": {
     "Bold": true,
     "Italic": false,
     "Underline": false
    }
   },
   {
    "Type": "Text",
    "X": 0,
    "Y": 900,
    "Font": "AlibabaPuHuiTi",
    "Content": "这里是横幅字幕\n可以加换行符进行多行展示",
    "Alignment": "TopCenter",
    "FontSize": 40,
    "FontColor": "#ffffff",
    "FontFace": {
     "Bold": true,
     "Italic": false,
     "Underline": false
    }
   },
   {
    "Type": "Text",
    "X": 0,
    "Y": 1000,
    "Font": "KaiTi",
    "Content": "设置字幕出入场时间",
    "Alignment": "TopCenter",
    "FontSize": 40,
    "FontColor": "#ffffff",
    "TimelineIn": 5,
    "TimelineOut": 25,
    "FontFace": {
     "Bold": false,
     "Italic": true,
     "Underline": false
    }
   }
  ]
 }]
}

添加字幕描边、阴影效果

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video4.mp4"
    }]
  }],
  "SubtitleTracks":[
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 210,
          "Font": "WenQuanYi Zen Hei Mono",
          "Content": "这里是副标题",
          "Alignment": "TopCenter",
          "FontSize": 50,
          "FontColor": "#000000",
          "TimelineIn": 0,
          "TimelineOut": 10,
          "OutlineColour": "#ffffff",
          "Outline": 2,
          "FontFace": {
            "Bold": false,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type":"Text",
          "X": 0,
          "Y": 270,
          "Font": "WenQuanYi Zen Hei Mono",
          "Content": "这里是标题",
          "Alignment": "TopCenter",
          "OutlineColour": "#000000",
          "Outline": 3,
          "FontSize": 70,
          "TimelineIn": 0,
          "TimelineOut": 10,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type": "Text",
          "Y": 750,
          "Font": "AlibabaPuHuiTi",
          "Content": "这里是大标题",
          "Alignment": "TopCenter",
          "FontSize": 100,
          "FontColor": "#FFD700",
          "Outline": 4,
          "OutlineColour": "#000000",
          "TimelineIn": 0,
          "TimelineOut": 10,
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type": "Text",
          "Y": 850,
          "Content": "自定义字体文件",
          "Font": "KaiTi",
          "FontSize": 42,
          "Outline": 2,
          "OutlineColour": "#ee00ff",
          "FontUrl":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_font.ttf",
          "TimelineIn": 0,
          "TimelineOut": 10,
          "Alignment": "TopCenter",
          "FontColor": "#000000",
          "FontFace": {
            "Bold": false,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type": "Text",
          "Y": 900,
          "Font": "WenQuanYi Zen Hei Mono",
          "Content": "阴影效果",
          "FontColor": "#ffffff",
          "FontSize": 40,
          "Outline": 2,
          "OutlineColour": "#DB7093",
          "Shadow": 3,
          "BackColour": "#FFF0F5",
          "TimelineIn": 0,
          "TimelineOut": 10,
          "Alignment": "TopCenter",
          "FontFace": {
            "Bold": false,
            "Italic": false,
            "Underline": false
          }
        },
        {
          "Type": "Text",
          "Y": 980,
          "Font": "WenQuanYi Zen Hei Mono",
          "Content": "添加字幕动画",
          "FontColor": "#ffffff",
          "FontSize": 50,
          "TimelineIn": 0,
          "TimelineOut": 10,
          "Alignment": "TopCenter",
          "AaiMotionLoopEffect": "rollleft_display",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    }
  ]
}

设置系统内置花字和自定义花字

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video.mp4",
      "In": 0,
      "Out": 8
    }]
  }],
  "SubtitleTracks": [{
    "SubtitleTrackClips": [{
        "TimelineIn": 0,
        "TimelineOut": 2,
        "Type": "Text",
        "Y": 0.2,
        "Font": "WenQuanYi Zen Hei Mono",
        "Content": "云端智能剪辑",
        "Alignment": "TopCenter",
        "FontSize": 200,
        "FontColor": "#FFFFFF",
        "SubtitleEffects": [{
            "Color": "#0420B6",
            "Type": "Shadow",
            "XBord": 0.07,
            "YBord": 0.07,
            "YShift": 0.06
          },
          {
            "Color": "#F2213F",
            "Type": "Shadow",
            "XBord": 0.07,
            "YBord": 0.07,
            "YShift": 0.03
          },
          {
            "Color": "#000000",
            "Type": "Shadow",
            "XShift": 0.01,
            "YShift": 0.01
          },
          {
            "Color": "#000000",
            "Type": "Outline",
            "XBord": 0.01,
            "YBord": 0.01
          }
        ]
      },
      {
        "TimelineIn": 0,
        "TimelineOut": 2,
        "Type": "Text",
        "Y": 0.6,
        "Content": "高级花字",
        "Alignment": "TopCenter",
        "FontSize": 150,
        "EffectColorStyle": "CS0001-000011"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.1,
        "Y": 0.1,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0001-000004"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.1,
        "Y": 0.3,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0001-000005"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.1,
        "Y": 0.5,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0001-000014"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.1,
        "Y": 0.7,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0001-000007"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.6,
        "Y": 0.1,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0002-000002"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.6,
        "Y": 0.3,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0002-000004"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.6,
        "Y": 0.5,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0002-000009"
      },
      {
        "TimelineIn": 2,
        "TimelineOut": 5,
        "Type": "Text",
        "X": 0.6,
        "Y": 0.7,
        "Content": "系统花字",
        "FontSize": 150,
        "EffectColorStyle": "CS0002-000016"
      },
      {
        "Comment": "增加左偏移阴影",
        "TimelineIn": 5,
        "TimelineOut": 8,
        "Type": "Text",
        "FontSize": 150,
        "Content": "自定义花字",
        "Y": 0.1,
        "Alignment": "TopCenter",
        "Font": "HappyZcool-2016",
        "FontColor": "#F688AA",
        "SubtitleEffects": [{
          "Color": "#F5D2CC",
          "Type": "Shadow",
          "XBord": 0,
          "YBord": 0,
          "XShift": -0.04,
          "Opacity": 1.0
        }]
      },
      {
        "Comment": "增加右偏移阴影",
        "TimelineIn": 5,
        "TimelineOut": 8,
        "Type": "Text",
        "FontSize": 150,
        "Content": "自定义花字",
        "Y": 0.3,
        "Alignment": "TopCenter",
        "Font": "HappyZcool-2016",
        "FontColor": "#F688AA",
        "SubtitleEffects": [{
            "Color": "#A33952",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": 0.04,
            "Opacity": 1.0
          },
          {
            "Color": "#F5D2CC",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": -0.04,
            "Opacity": 1.0
          }
        ]
      },
      {
        "Comment": "增加第一层发光",
        "TimelineIn": 5,
        "TimelineOut": 8,
        "Type": "Text",
        "FontSize": 150,
        "Content": "自定义花字",
        "Y": 0.5,
        "Alignment": "TopCenter",
        "Font": "HappyZcool-2016",
        "FontColor": "#F688AA",
        "SubtitleEffects": [{
            "Color": "#FFFFA0",
            "Type": "Shadow",
            "Blur": 0.08,
            "XBord": 0.08,
            "YBord": 0.08
          },
          {
            "Color": "#A33952",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": 0.04,
            "Opacity": 1.0
          },
          {
            "Color": "#F5D2CC",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": -0.04,
            "Opacity": 1.0
          }
        ]
      },
      {
        "Comment": "增加第二层发光",
        "TimelineIn": 5,
        "TimelineOut": 8,
        "Type": "Text",
        "FontSize": 150,
        "Content": "自定义花字",
        "Y": 0.7,
        "Alignment": "TopCenter",
        "Font": "HappyZcool-2016",
        "FontColor": "#F688AA",
        "SubtitleEffects": [{
            "Color": "#F688AA",
            "Type": "Shadow",
            "Blur": 0.30,
            "XBord": 0.15,
            "YBord": 0.15
          },
          {
            "Color": "#FFFFA0",
            "Type": "Shadow",
            "Blur": 0.08,
            "XBord": 0.08,
            "YBord": 0.08
          },
          {
            "Color": "#A33952",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": 0.04,
            "Opacity": 1.0
          },
          {
            "Color": "#F5D2CC",
            "Type": "Shadow",
            "XBord": 0,
            "YBord": 0,
            "XShift": -0.04,
            "Opacity": 1.0
          }
        ]
      }
    ]
  }]
}

设置字幕局部效果

通过在Content字段中添加覆写代码,设置字幕局部效果。覆写代码说明如下所示:

  • 所有覆写代码均以两个反斜杠(\\)开头。

  • 所有局部参数覆写代码必须在{}中,且一个{}可以包含多个覆写代码。

  • 覆写代码会作用于其后的字幕上,如果想要结束该覆写代码,需要加一个与之对应的结束覆写代码来取消该效果。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/6.mov"
                }
            ]
        }
    ],
    "SubtitleTracks": [
        {
            "SubtitleTrackClips": [
                {
                    "Type": "Text",
                    "X": 0,
                    "Y": 150,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\1c&0801ea&\\3c&f7fcff&}深红色{\\1c\\3c}",
                    "Alignment": "TopCenter",
                    "FontSize": 65,
                    "FontColor": "#F5FFFA",
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "X": 0,
                    "Y": 300,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\fs100}100号{\\fs}字体",
                    "Alignment": "TopCenter",
                    "FontColor": "#F5FFFA",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 450,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\bord3\\3c&CD0000&}描边{\\bord\\3c}颜色和大小",
                    "Alignment": "TopCenter",
                    "FontSize": 65,
                    "FontColor": "#F5FFFA",
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 600,
                    "Content": "这里设置{\\bord3\\3c&701919&}不透明背景{\\bord\\3c}颜色和大小",
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Alignment": "TopCenter",
                    "FontColor": "#F5FFFA",
                    "BorderStyle": 3,
                    "Outline": 0,
                    "OutlineColour": "#0000CD"
                },
                {
                    "Type": "Text",
                    "Y": 750,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\fnKaiTi}黑体{\\fn}字体",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "FontColor": "#F5FFFA",
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 900,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\b1}加粗{\\b0}效果",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "FontColor": "#F5FFFA",
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 1050,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\i1}斜体{\\i0}效果",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "FontColor": "#F5FFFA",
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 1200,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\u1}下划线{\\u0}效果",
                    "FontColor": "#F5FFFA",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 1350,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\s1}删除线{\\s0}效果",
                    "FontColor": "#F5FFFA",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "Y": 1500,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "这里设置{\\1c&00FF00&\\b1\\fs100\\i1}组合{\\1c\\b0\\fs\\i0}效果",
                    "FontColor": "#F5FFFA",
                    "FontSize": 65,
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Alignment": "TopCenter",
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                }
            ]
        }
    ]
}

覆写参数详细说明:

覆写参数

描述

Content参数示例

  • \\1c&[BBGGRR]&

  • \\2c&[BBGGRR]&

  • \\3c&[BBGGRR]&

1c、2c、3c分别为字体、边框、阴影对应的颜色;[BBGGRR]是十六进制的颜色BGR值,与一般的RGB颜色顺序相反。

"这里设置{\\1c&00FF7F&}绿{\\1c}色"

  • \\bord[宽度]

  • \\xbord[宽度]

  • \\ybord[宽度]

bord、xbord、ybord分别为边框、沿X轴边框、沿Y轴边框对应的宽度,单位为像素。

"这里设置{\\bord3\\3c&EBCE87&}描边宽度{\\bord\\3c}颜色和大小"

\\b1 \\b0

b1为加粗,b0为取消加粗。

"这里设置{\\b1}加粗{\\b0}效果",

\\i1 \\i0

i1为斜体,i0为取消斜体。

"这里设置{\\i1}斜体{\\i0}效果"

\\u1 \\u0

u1为加下划线,u0为取消下划线。

"这里设置{\\u1}下划线{\\u0}效果"

\\s1 \\s0

s1为加文本删除线,s0为取消删除线。

"这里设置{\\s1}删除线{\\s0}效果"

\\fs[字体尺寸]

字幕大小,单位为像素。

"这里设置{\\fs100}100号{\\fs}文字"

\\fn[字体名称]

字幕名称,暂不支持设置自定义字体。

"这里设置{\\fnKaiTi}黑体{\\fn}字体"

设置字幕自动换行

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/6.mov"
                }
            ]
        }
    ],
    "SubtitleTracks": [
        {
            "SubtitleTrackClips": [
                {
                    "Type": "Text",
                    "X": 0,
                    "Y": 400,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "当不设置字幕自动换行或自动缩放时会超出视频画布",
                    "Alignment": "TopCenter",
                    "FontSize": 100,
                    "FontColor": "#F5FFFA",
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "X": 0,
                    "Y": 900,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "当字幕超出视频尺寸时触发自动换行",
                    "AdaptMode": "AutoWrap",
                    "Alignment": "TopCenter",
                    "FontSize": 100,
                    "FontColor": "#F5FFFA",
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                },
                {
                    "Type": "Text",
                    "X": 0,
                    "Y": 1400,
                    "FontURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/material/AliHYAiHei.ttf",
                    "Content": "当字幕超出视频尺寸时触发自动缩放",
                    "AdaptMode": "AutoScale",
                    "Alignment": "TopCenter",
                    "FontSize": 100,
                    "FontColor": "#F5FFFA",
                    "TimelineIn": 0,
                    "TimelineOut": 10,
                    "Outline": 2,
                    "OutlineColour": "#0e0100"
                }
            ]
        }
    ]
}

添加GIF贴纸

配置DyncFrames字段,设置动图的帧率。

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4"
    },{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4"
    },{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4"
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_sticker1.gif",
      "Type": "image",
      "Duration": 10,
      "TimelineIn": 0,
      "DyncFrames": 10,
      "X": 50,
      "Y": 1300,
      "Effects": [{
        "Type": "Scale",
        "Width": 200,
        "Height": 200
      }]
    },{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_sticker2.gif",
      "Type": "image",
      "Duration": 10,
      "TimelineIn": 10,
      "DyncFrames": 10,
      "X": 800,
      "Y": 400,
      "Effects": [{
        "Type": "Scale",
        "Width": 200,
        "Height": 200
      }]
    },{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_sticker3.gif",
      "Type": "image",
      "Duration": 10,
      "TimelineIn": 20,
      "DyncFrames": 10,
      "X": 100,
      "Y": 400,
      "Effects": [{
        "Type": "Scale",
        "Width": 200,
        "Height": 200
      }]
    }]
  }]
}

全局特效、滤镜

如果需要为整个视频添加特效、滤镜,需要在EffectTrack属性中添加特效,无需设置TimelineInTimelineOut,特效会从第0秒渲染至视频结束,常用于配置全局特效。

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4"
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4"
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4"
  }]
 }],
 "EffectTracks": [{
  "EffectTrackItems": [{
   "Type": "Filter",
   "SubType": "PL2"
  }]
 }]
}

设置全局背景和全局Logo

通过配置"Type": "GlobalImage"(无需配置Duration),默认将图片从视频第0秒显示到视频结束。

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/720P_background.jpg",
   "Type": "GlobalImage"
  }]
 }, {
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/1.mp4",
   "Effects": [{
    "Type": "Volume",
    "Gain": 0
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/2.mp4",
   "Effects": [{
    "Type": "Volume",
    "Gain": 0
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/3.mp4",
   "Effects": [{
    "Type": "Volume",
    "Gain": 0
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/4.mp4",
   "Effects": [{
    "Type": "Volume",
    "Gain": 0
   }]
  }, {
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/5.mp4"
  }]
 }, {
  "VideoTrackClips": [{
   "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video/aliyun_logo_white.png",
   "Type": "GlobalImage",
   "X": 0.1,
   "Y": 0.1,
   "Width": 247,
   "Height": 74
  }]
 }]
}

语音转文字并将字幕合并到视频中

设置"Type": "AI_ASR"可以将音视频中的语音转换成文字,同时可以设置字幕样式,例如:字体、颜色等。

说明

语音转文字服务只支持华东2(上海)、华北2(北京)、华东1(杭州)和华南1(深圳)地域。

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video7.mp4",
      "Effects": [{
        "Type": "AI_ASR",
        "Font": "AlibabaPuHuiTi",
        "Alignment": "TopCenter",
        "Y": 910,
        "Outline": 10,
        "OutlineColour": "#ffffff",
        "FontSize": 60,
        "FontColor": "#000079",
        "FontFace": {
          "Bold": true,
          "Italic": false,
          "Underline": false
        }
      }]
    }]
  }]
}

文字转语音并将语音合并到视频中

设置"Type": "AI_TTS"可以将文字转换成语音,可以与"Type": "AI_ASR"共用。其中,Content为要转换的文字,同时可以设置语音属性,例如:Voice、SpeechRate、PitchRate、Format等。

说明
  • 文字转语音和语音转文字服务都只支持华东2(上海)、华北2(北京)和华东1(杭州)地域。

  • AI_TTS默认根据中文逗号、句号等标点符号进行断句,开发者可以控制每个断句的字幕样式,以及换行模式。

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
      "Effects": [{
        "Type":"Volume",
        "Gain":0
      }]
    }]
  }],
  "AudioTracks": [{
    "AudioTrackClips": [{
      "Type": "AI_TTS",
      "Content": "君不见黄河之水天上来,奔流到海不复回。君不见高堂明镜悲白发,朝如青丝暮成雪。",
      "Voice": "sicheng",
      "Effects": [{
        "Type": "AI_ASR",
        "Font": "AlibabaPuHuiTi",
        "Alignment": "TopCenter",
        "Y": 900,
        "FontSize": 80,
        "FontColor": "#ffffff",
        "FontFace": {
          "Bold": true,
          "Italic": false,
          "Underline": false
        }
      },{
        "Type":"Volume",
        "Gain":10
      }]
    }]
  }]
}

绿幕抠图合成效果

设置"Type": "AI_Matting"可以将被摄物体从绿幕背景色中抠出,叠加到指定的背景视频或图片上。

说明

绿幕抠图服务只支持华东1(杭州)、华东2(上海)和华北2(北京)地域。

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaId": "******aacb1740e3a8a1f8d433******",
   "Type": "GlobalImage"
  }]
 }, {
  "VideoTrackClips": [{
   "MediaId": "******6aae104549adb6104e5a******",
   "Effects": [{
    "Type": "AI_Matting",
    "Color": "green",
    "Auto": 1,
    "Thres": 10
   }]
  }]
 }]
}

实景抠图合成效果

设置"Type": "AI_RealMatting"可以将人像从任意实景中抠出,叠加到指定的背景视频或图片上。

说明

实景抠图服务只支持华东1(杭州)、华东2(上海)和华北2(北京)地域。

{
	"VideoTracks": [
		{
			"VideoTrackClips": [
				{
					"MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/***.jpg",
					"Type": "GlobalImage",
					"Width": 0.5,
					"Height": 1,
					"X": 0.5,
					"Y": 0,
					"AdaptMode": "Cover"
				}
			]
		},
		{
			"VideoTrackClips": [
				{
					"MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/***.mp4",
					"In": 0,
					"Out": 10,
					"Width": 0.5,
					"Height": 1,
					"AdaptMode": "Cover",
					"X": 0.5,
					"Effects": [
						{
							"Type": "AI_RealMatting",
							"Thres": 8
						},
						{
							"Type": "Crop",
							"X": 0.25,
							"Height": 1,
							"Width": 0.5
						},
						{
							"Type": "Text"
						}
					]
				}
			]
		},
		{
			"VideoTrackClips": [
				{
					"MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/***.mp4",
					"In": 0,
					"Out": 10,
					"Width": 0.5,
					"Height": 1,
					"AdaptMode": "Cover",
					"Effects": [
						{
							"Type": "Crop",
							"X": 0.25,
							"Height": 1,
							"Width": 0.5
						},
						{
							"Type": "Volume",
							"Gain": 0
						}
					]
				}
			]
		}
	]
}

AI_TTS使用SSML标记语言修正文字读音

AI_TTS中的Content字段支持SSML标记语言,可用于修正专业词汇读音、添加停顿、多情感音效,详情请参见SSML标记语言介绍

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "Type": "Image",
      "MediaURL": "https://your-bucket***.oss-cn-shanghai.aliyuncs.com/your-image1.jpg",
      "Duration": 3,
      "Effects": [{
          "Radius": 0.1,
          "Type": "Background",
          "SubType": "Blur"
        },
        {
          "Type": "Transition",
          "SubType": "windowslice",
          "Duration": 0.3
        }
      ]
    }, {
      "Type": "Image",
      "MediaURL": "https://your-bucket***.oss-cn-shanghai.aliyuncs.com/your-image2.jpg",
      "Duration": 3,
      "Effects": [{
          "Radius": 0.1,
          "Type": "Background",
          "SubType": "Blur"
        },
        {
          "Type": "Transition",
          "SubType": "windowslice",
          "Duration": 0.3
        }
      ]
    }, {
      "Type": "Image",
      "MediaURL": "https://your-bucket***.oss-cn-shanghai.aliyuncs.com/your-image3.jpg",
      "Duration": 3,
      "Effects": [{
          "Radius": 0.1,
          "Type": "Background",
          "SubType": "Blur"
        },
        {
          "Type": "Transition",
          "SubType": "windowslice",
          "Duration": 0.3
        }
      ]
    }]
  }],
  "AudioTracks": [{
    "MainTrack": true,
    "AudioTrackClips": [{
      "Type": "AI_TTS",
      "Voice": "zhichu",
      "Content": "PU线,全名Polyurethane线条,是用PU合成原料制作的线条,中文名为聚氨基甲酸酯,简称聚氨酯,以硬质PU泡棉制成",
      "Effects": [{
        "Type": "AI_ASR",
        "Font": "AlibabaPuHuiTi",
        "Alignment": "TopCenter",
        "Y": 1000,
        "FontSize": 50,
        "FontColor": "#ffffff",
        "AdaptMode": "AutoWrap",
        "Outline": 1,
        "OutlineColour": "#0e0100",
        "FontFace": {
          "Bold": true,
          "Italic": false,
          "Underline": false
        }
      }, {
        "Type": "Volume",
        "Gain": 1
      }]
    }, {
      "Type": "AI_TTS",
      "Voice": "zhichu",
      "Content": "<speak><sub alias=\"批优\">PU</sub>线,全名Polyurethane线条, 是用<sub alias=\"批优\">PU</sub>合成原料制作的线条,中文名为聚氨基甲酸酯, 简称聚氨酯,以硬质<sub alias=\"批优\">PU</sub>泡棉制成</speak>",
      "Effects": [{
        "Type": "AI_ASR",
        "Font": "AlibabaPuHuiTi",
        "Alignment": "TopCenter",
        "Y": 1000,
        "FontSize": 50,
        "FontColor": "#ffffff",
        "AdaptMode": "AutoWrap",
        "Outline": 1,
        "OutlineColour": "#0e0100",
        "FontFace": {
          "Bold": true,
          "Italic": false,
          "Underline": false
        }
      }, {
        "Type": "Volume",
        "Gain": 1
      }]
    }]
  }],
  "SubtitleTracks": [{
    "SubtitleTrackClips": [{
      "Type": "Text",
      "X": 0,
      "Y": 200,
      "Font": "AlibabaPuHuiTi",
      "Content": "普通AI_TTS,专业词汇\"PU\"读音不准确",
      "Alignment": "TopCenter",
      "FontSize": 70,
      "FontColorOpacity": 1,
      "FontColor": "#990000",
      "AaiMotionLoopEffect1": "slingshot_in",
      "Outline": 1,
      "OutlineColour": "#ffffff",
      "TimelineIn": 0,
      "TimelineOut": 13,
      "AdaptMode": "AutoWrap",
      "FontFace": {
        "Bold": true,
        "Italic": false,
        "Underline": false
      }
    }, {
      "Type": "Text",
      "X": 0,
      "Y": 200,
      "Font": "AlibabaPuHuiTi",
      "Content": "AI_TTS使用了SSML标记,专业词汇\"PU\"读音被修正",
      "Alignment": "TopCenter",
      "FontSize": 70,
      "FontColorOpacity": 1,
      "FontColor": "#006633",
      "Outline": 1,
      "OutlineColour": "#ffffff",
      "TimelineIn": 13,
      "AdaptMode": "AutoWrap",
      "FontFace": {
        "Bold": true,
        "Italic": false,
        "Underline": false
      }
    }]
  }]
}
  • 本页导读 (1)
文档反馈