调用AddTemplate接口,创建模板。支持设置模板名称,模板Config。

模板工厂是对剪辑合成时间线的一个封装,用户可以把常用的时间线定义成模板,当有同样的需求出现时,只需要传入关键参数及素材即可生产视频。

调试

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

请求参数

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

系统规定参数。取值:AddTemplate

Name String 模板名称

模板名称

Type String Timeline

模板类型,目前支持:

  • Timeline
  • VETemplate
Config String 参见Config文档

模板Config,参参考:

CoverUrl String http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg

模板封面

PreviewMedia String ****01bf24bf41c78b2754cb3187****

模板预览视频MediaId

Status String Normal

模板状态,取值范围:

  • Available
  • Created
  • Uploading
  • Processing
  • UploadFailed
  • ProcessFailed
Source String OpenAPI

模板创建来源,取值范围:

  • OpenAPI
  • AliyunConsole
  • WebSDK

返回数据

名称 类型 示例值 描述
RequestId String ****2876-6263-4B75-8F2C-CD0F7FCF****

Id of the request

Template Object

模板信息

TemplateId String ****01bf24bf41c78b2754cb3187****

模板Id

Name String 模板名称

模板名称

Type String Timeline

模板类型

Config String 参见Config文档

参见Timeline模板Config文档

CoverUrl String http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg

模板封面

PreviewMedia String ****01bf24bf41c78b2754cb3187****

预览视频媒资id

Status String Normal

模板状态

CreateSource String OpenAPI

模板创建来源

ModifiedSource String OpenAPI

模板修改来源

示例

请求示例

GET /?Action=AddTemplate&Name=模板名称&Type=Timeline&Config=参见Config文档&CoverUrl=http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg&PreviewMedia=****01bf24bf41c78b2754cb3187****&Status=Normal&Source=OpenAPI&RelatedMediaids={"video":["******c04f1d4a06996144cc1a******","******cb7db64841b159b4f2ea******"],"audio":["******c04f1d4a06996144cc1a******"],"image":["******c04f1d4a06996144cc1a******"]}&公共请求参数 HTTP/1.1

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddTemplateResponse>
    <RequestId>****2876-6263-4B75-8F2C-CD0F7FCF****</RequestId>
    <Template>
        <TemplateId>****01bf24bf41c78b2754cb3187****</TemplateId>
        <Name>模板名称</Name>
        <Type>Timeline</Type>
        <Config>参见Config文档</Config>
        <CoverUrl>http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg</CoverUrl>
        <PreviewMedia>****01bf24bf41c78b2754cb3187****</PreviewMedia>
        <Status>Normal</Status>
        <CreateSource>OpenAPI</CreateSource>
        <ModifiedSource>OpenAPI</ModifiedSource>
    </Template>
</AddTemplateResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "****2876-6263-4B75-8F2C-CD0F7FCF****",
  "Template" : {
    "TemplateId" : "****01bf24bf41c78b2754cb3187****",
    "Name" : "模板名称",
    "Type" : "Timeline",
    "Config" : "参见Config文档",
    "CoverUrl" : "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
    "PreviewMedia" : "****01bf24bf41c78b2754cb3187****",
    "Status" : "Normal",
    "CreateSource" : "OpenAPI",
    "ModifiedSource" : "OpenAPI"
  }
}

错误码

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。