You need to enable JavaScript to run this app.
导航
模板概念以及模板消费API介绍
最近更新时间:2022.06.06 10:22:32首次发布时间:2022.06.06 10:16:00

智能创作云提供的剪同款模板,不仅支持SaaS的使用,还支持通过API形式对外开放。本文档是模板相关的概念和模版消费的介绍说明。

槽位概念说明

在模板被渲染为视频时,视频中的部分内容由模板中的槽位决定。槽位也表示为一个dict,其代表了一个素材(文本、视频或图片),如下为几种槽位示例:

video类型槽位
{
    "type": "video",
    "uuid": "163732657018069093923990821728",
    "clip_end": 2.0,
    "clip_start": 0.0,
    "starttime": 1.0,
    "endtime": 3.0,
    "source": "http://xxxxx",
    "volume": 100,
    "crop": [[-1.0,-1.0],[-1.0,1.0],[1.0,1.0],[1.0,-1.0]]
}

text类型槽位
{
    "type": "text",
    "uuid": "163732657018069093923990821728",
    "prefix":"this_is_prefix", //不一定有
    "starttime": 1.2,
    "endtime": 3.6,
    "text": "你好",
}

temptext类型槽位
{
    "type": "temptext",
    "uuid": "163844198916484994010111755664",
    "endtime": 2.5380001068115234,
    "starttime": 0.0,
    "text": {
        0: "民宿打卡•像住在城堡里"  //  key为索引,不可修改,value为文本
        1: "民宿打卡•像住在城堡里"  //  同上
    }
}
槽位中的字段说明如下:
  1. type:只读,槽位类型,目前支持video、text、temptext

  2. uuid:只读,槽位的唯一id,用于映射槽位到模板中的节点

  3. starttime:只读,槽位在最终视频中的开始时间,单位秒

  4. endtime:只读,槽位在最终视频中的结束时间,单位秒

  5. clip_start:视频裁切起点,单位秒(当source指向视频链接时,此字段生效;链接中的视频会被裁剪后再使用,裁剪起始时间为clip_start,裁剪结束时间点为clip_end)

  6. clip_end:视频裁切终点,单位秒(当source指向视频链接时,此字段生效;控制视频裁剪的结束时间点)

  7. source:资源路径,http链接。注:如果type为video,则source不仅可以传视频链接还可以传图片链接

  8. volume:音量

  9. text:text或temptext类型槽位中的文本细节

  10. prefix:渲染时需要,不可修改

  11. crop:video槽位中视频或图片的裁切坐标,分别是从左下角开始顺时针的4个点,坐标原点在图像中心,右上方为正坐标。例:全图坐标为[[-1.0,-1.0],[-1.0,1.0],[1.0,1.0],[1.0,-1.0]]。x和y坐标需要分别除以二分之一宽高,因此坐标范围是[-1,1]。

一个模板可以含有数个槽位。在将模板渲染为视频时,text类型槽位内部的text字段会被放进视频中;而video类型槽位内部的source字段为http链接,这个http链接指向一个视频或者图片,那么这个被指向的视频或图片就会被放入视频中。因此,更改text类型槽位中的text字段可以改变视频中出现的文案信息,更改video类型槽位中的source字段,可以改变视频中出现的视频片段或图片。
因此用户只要更换槽位中的text字段或者source字段便可生成不同的视频。

注:模板在存储时,槽位会被逐个提取出来,单独存储在一个列表中。

OpenApi模板消费功能说明

OpenApi旨在提供接口,接受用户提供的图像、文字、视频,并将这些多媒体素材放入模板,然后将模板渲染成视频并返回。

OpenApi模板消费介绍

OpenApi旨在提供接口,接受用户提供的图像、文字、视频,并将这些多媒体素材放入模板,然后将模板渲染成视频并返回。
OpenApi模板消费大致步骤如下:

  1. 用户可以调用模板搜索接口或者通过模板id获取到模板详细信息(其中包含槽位列表)

  2. 修改槽位列表中各槽位的text字段或者source字段

  3. 用户将模板id以及修改过后的槽位列表等信息传入OpenApi提供的视频生成接口,启动一个视频生成任务,接口会返回一个任务id,用于后续查询任务结果

  4. 接口会根据槽位中的uuid将槽位放进模板中的相应位置,然后将模板渲染成视频

  5. 用户调用查询任务接口,输入任务id,获取该任务生成的视频等相关信息

注:消费时获取到的模板槽位列表,其中每个槽位的字段都是事先定义好的,使用时不可新增字段或删除字段,也不可新增槽位或删除槽位,只可修改槽位中允许被修改的字段。