本文档介绍通用视频生成GenerateVideo的语法及示例。

功能描述

GenerateVideo可以根据输入的原始视频,智能生成营销短视频。

前提条件

请确保您已开通视频生产服务,具体请参见服务开通

输入限制

  • 输入类型支持MP4、AVI、MKV、MOV、JPG、PNG、BMP、MP3、WAV。
  • 视频素材最多5个,且总时长不超过3分钟,超过部分会被自动截断丢弃。图像素材最多40个。音频素材最多1个。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GenerateVideo

要执行的操作。取值:GenerateVideo。

FileList.N.FileName String test

输入文件名称。视频音频文件格式为MP4或MP3时,可以忽略文件后缀。其他格式必须包含后缀。

FileList.N.FileUrl String https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/CommonShared/emian_test_only/videoSumm/IMG_8295.mp4

输入文件URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

FileList.N.Type String video

输入文件类型。包括video、audio、image。

Scene String costume

生成视频场景类型。支持costume(服饰场景)和general(通用场景)两种场景。默认为costume。

Width Integer 640

输出视频的width,取值范围32~2160。

Height Integer 640

输出视频的height,取值范围32~2160。若width和height均没有设置,则按照750×750输出。如果设置了其中一个,则按照1:1输出。

Style String fast

输出视频节奏。可选normal、fast、slow。默认为normal。

Duration Float 10

输出视频时长,单位为秒。默认为20秒。

DurationAdaption Boolean true

输出视频时长自适应。取值true或false,为true时Duration设置不生效。

TransitionStyle String brush

镜头转场风格。共计15种风格。如果没有设置则按照Style随机。

目前支持的镜头转场风格包括:basic(无)、slow(舒缓)、fast(动感)、normal(自然)、ink(水墨)、glitch(机械故障)、shift(切换)、mosaic(马赛克)、shutter(百叶窗)、zoom(缩放)、mask(遮罩)、brush(笔刷)、wind(风舞)、smog(烟雾)。

SmartEffect Boolean true

是否添加智能特效,默认为true。当前支持音画联动和静转动特效。

PuzzleEffect Boolean true

是否动态拼图特效,支持在单镜头中通过拼图展示多个视频图像素材。默认为false。

Mute Boolean true

生成视频是否静音。默认为false。

说明 如果没有音乐素材或视频素材无声时生成的视频没有音乐。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

VideoCoverUrl String //algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/shop-video-abs%2F2020-04-03-16%2F1_u1ljql.jpg?OSSAccessKeyId=LTAI4FkXB4tQxhWhdCzM****&Expires=1617440044&Signature=WLZD%2FCMkP9CVEc%2F%2BB3yo9K7EoJ****

输出视频封面URL地址。

VideoUrl String https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/CommonShared/emian_test_only/videoSumm/IMG_8295.mp4

输出视频URL地址。

RequestId String 7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GenerateVideo
&FileList.1.FileName=test
&FileList.1.FileUrl=https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/CommonShared/emian_test_only/videoSumm/IMG_8295.mp4
&FileList.1.Type=video
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>

JSON 格式

{
  "RequestId": "7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4"
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。具体请参见GetAsyncJobResult

错误码

具体请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。