GenerateVideo
通用视频生成GenerateVideo的语法及示例
服务地址:
华东2(上海)
输入参数
只看必填
Scene生成视频场景类型
Width输出视频的width
Height输出视频的height
Style输出视频节奏
Duration输出视频时长
DurationAdaption输出视频时长自适应
请选择布尔值
TransitionStyle镜头转场风格
SmartEffect是否添加智能特效
请选择布尔值
PuzzleEffect是否动态拼图特效
请选择布尔值
Mute生成视频是否静音
请选择布尔值
FileList1
01
Type输入文件类型
FileUrl输入文件URL地址
FileName输入文件名称
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

通用视频生成能力可以根据输入的原始视频,智能生成营销短视频。支持图像、视频、音频等素材混合处理,支持转场特效等加工效果叠加。输入视频的场景类型可选择服饰场景(默认)或通用场景,通过分析视频中的人和物,生成故事线来组织素材的顺序。您也可以通过输入参数的设置强制按输入素材顺序合成视频场景。

通用视频生成能力主要包含以下功能点:

  • 输入文件类型:支持 video(视频)、audio(音频)、image(图像)中的一种或多种。
  • 输出视频节奏:可选 normal(普通)、fast(快)、slow(慢),默认为 normal(普通)。
  • 镜头转场风格的选择:共计 15 种风格,如果没有设置则按照 Style 随机,目前支持的镜头转场风格包括:basic(无)、slow(舒缓)、fast(动感)、normal(自然)、ink(水墨)、glitch(机械故障)、shift(切换)、mosaic(马赛克)、shutter(百叶窗)、zoom(缩放)、mask(遮罩)、brush(笔刷)、wind(风舞)、smog(烟雾)。
  • 智能特效:当前支持音画联动和静转动特效,默认添加。
  • 动态拼图特效:支持在单镜头中通过拼图展示多个视频图像素材,默认不添加。
说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 信息流广告制作:基于提供的素材批量生成广告视频,进行低成本投放。
    • 短视频二次加工:基于提供的视频内容和图片素材,进行新的视频素材制作。

    特色优势

    • 全自动生产:根据业务需要配置参数,自动化生产视频。
    • 功能丰富:支持多种素材输入,支持转场特效等,实现更丰富的业务场景应用。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

    2. 开通能力:请确保您已开通视频生产服务,若未开通服务请立即开通

    3. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权

    4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。

    5. 开发接入步骤:

      • SDK 总览中选择您要接入使用的 SDK 语言。
      • 在对应语言的 SDK 文档中找到 AI 类目为视频生产(videoenhan)类目的 SDK 包进行安装。
      • 参考文档中提供的示例代码进行适当修改后调用。
    6. 示例代码:该能力常用语言的示例代码,请参见通用视频生成示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

    • 图片格式:JPG、PNG。
    • 图片大小:每张图片大于 30 KB,小于 100 MB。
    • 视频格式:MP4、AVI、MKV、MOV、JPG、PNG、BMP、MP3、WAV。
    • 视频大小:不超过 1 GB。
    • 视频素材最多 5 个,且总时长不超过 3 分钟,超过部分会被自动截断丢弃(按输入视频顺序保留前 3 分钟)。图像素材最多 40 个。音频素材最多 1 个。
    • URL 地址中不能包含中文字符。

    计费说明

    关于通用视频生成的计费方式及报价,请参见计费介绍

    说明 下方调试接口为付费接口。

    调用步骤

    该能力为异步能力,需分两步进行调用。 第一步调用 GenerateVideo 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。

    请求参数

    字段名称字段详情
    Scenestring

    生成视频场景类型。取值如下:展开详情

    示例值:costume
    Widthinteger<int32>

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

    示例值:640
    Heightinteger<int32>

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

    示例值:640
    Stylestring

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

    示例值:fast
    Durationnumber<float>

    输出视频时长,单位为秒。默认为 20 秒。展开详情

    示例值:10
    DurationAdaptionboolean

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

    示例值:true
    TransitionStylestring

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

    示例值:brush
    SmartEffectboolean

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

    示例值:true
    PuzzleEffectboolean

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

    示例值:true
    Muteboolean

    生成视频是否静音。默认为 false。展开详情

    示例值:true
    FileListarray<object>

    1

    子级条数 <= 300

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4
    Dataobject

    返回的结果数据内容。展开详情

    Messagestring

    提交异步任务后的提示信息。

    示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

    返回说明

    查询结果

    您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。具体操作,请参见 GetAsyncJobResult 。其中 Result 字段为返回结果的 JSON 序列化字符串,JSON 中字段说明请参见返回数据中的 Data 参数。

    SDK 参考

    阿里云视觉 AI 视频生产类目下的通用视频生成能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为视频生产(videoenhan)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见通用视频生成示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    变更历史
    变更时间变更内容概要操作
    2022-10-17
    变更返回参数