模板概念以及模板消费API介绍

智能创作云提供的剪同款模板，不仅支持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模板消费大致步骤如下：

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

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

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

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

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

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