# 槽位概念说明在模板被渲染为视频时，视频中的部分内容由模板中的槽位决定。槽位也表示为一个dict，其代表了一个素材（文本、视频或图片），如下为几种槽位示例： ```json 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，获取该任务生成的视频等相关信息注：消费时获取到的模板槽位列表，其中每个槽位的字段都是事先定义好的，使用时不可新增字段或删除字段，也不可新增槽位或删除槽位，只可修改槽位中允许被修改的字段。

创作Agent