接口2：查询模版列表--创意互动Vlog-火山引擎

文档中心

立即注册

导航

接口2：查询模版列表

最近更新时间：2024.08.23 10:23:54首次发布时间：2024.06.21 12:46:12

描述

查询景区可用模板列表。

Action

ListTemplates

入参

字段	类型	是否必填	描述
ScenicSpotId	string	是	景区ID。
TemplateId	string	否	模板 ID。
Group	string	否	分组名称。

出参

字段	类型	允许为空	描述
TotalCount	int64	是	模板总数。
Templates	[]Template	是	模板信息。

Template 模板信息

字段	类型	允许为空	描述
ScenicSpotId	string	否	景区 ID。
TemplateId	string	否	模板 ID。
Name	string	否	模板名称。
SlotNum	int64	否	模板槽位数量。
MaxSlotDuration	float64	否	不区分槽位类型，最大槽位时长，单位s，精确到毫秒。
SlotInfos	[]SlotInfo	是	模板槽位信息
Status	string	否	状态，取值范围：Allow：正常；Deny：禁用。
CoverUrl	string	否	封面地址，有效期 24 小时。
PreviewUrl	string	否	预览地址，有效期 24 小时。
Group	string	是	分组名称，成片时可指定在分组内随机选择模板成片。
CreateTime	string	否	创建时间，ISO 时间格式。
UpdateTime	string	否	更新时间，ISO 时间格式。

SlotInfo 槽位类型数量信息

字段	类型	允许为空	描述
Type	string	否	槽位类型 preset: 空镜槽位 aigc:aigc槽位 position:机位槽位
Num	int	否	数量
MaxDuration	float64	否	槽位最大时长，单位s，精确到毫秒注：要求使用该模板的素材时长>机位槽位的最大时长。

输出的形式是：
空镜槽位、数量5个、最大时长5秒
aigc槽位、数量1个、最大时长2秒
机位槽位、数量3个、最大时长4秒

示例

{
    "ResponseMetadata": {
        "RequestId": "2024082021142563C929DF0823144C8F36",
        "Action": "ListTemplates",
        "Version": "2022-11-08",
        "Service": "vlog",
        "Region": "cn-north-1"
    },
    "Result": {
        "TotalCount": 2,
        "Templates": [
            {
                "ScenicSpotId": "zyhl",
                "TemplateId": "7403643991570382884",
                "Name": "测试模板",
                "Description": "测试模板",
                "CoverUrl": "https://photographer.iccvlog.com/api/storage/objects/media/7403644386845655077_transcode_image_png_480p/e9c713a4-b523-4334-a474-f1bd3eaf99fa_png_480p.png?x-muse-token=ChYIARABGJSUkrYGIJS3l7YGKgQzMjA0EpgBCg0InoCItrfntoZjEOxbEgAaAhgCIggKAmhsEgJjbioGCNo0EIYDMikKJ3siYml6X2lkIjoiMTAwMDAwMDAxIiwiZGVyaXZlZF91aWQiOiIifUIUChJpY2FyY2guaWFtLmF1dGhycGNKLi9hcGkvc3RvcmFnZS9vYmplY3RzL21lZGlhLzc0MDM2NDQzODY4NDU2NTUwNzca2AJlM25RRldCaTZwRUk5TzYwYllyUnRQV3JKMzFTaEl3ZTl6YzdVZlZhTGliUU1BNFBTdGJuUHB4MlVWWmtDaDRTZUh4U1pKRXBmbjNLQk03MU5HM0xNTDVhUisxWW9FbENkdWpPRU9TN3o5OENyM1dEeEsvU0dRSk9QY3ZjRVM3eGxyc0pJdWw5UWFxNXlwejAwT3ZINnAySCtCOUk1T3FKcm54T3JpejFHbEtDRm5qWkdEcloxZkNpOVh3WnQ4YkpqRXVQWTYvWUU2TWdHY3hEYUVkajgxLzNlS1h2MzNKRkpuRWRRUk9FcWRjR1lQUTdTc1phMVAyS1ptQmJHY3JLRFg5QlV6TkErK3ZvOFJaUm1KeDlJRnBHbHJwRHJXSUxrN0VQdXJ1ZlBrY1ZQMTU3dzhoKzN4eHh6YUErTFYyQkI5R1A5N3NkWG02MDZLV1FZdnlVM1E9PQ%3D%3D&infer_mime=ext",
                "PreviewUrl": "https://photographer.iccvlog.com/api/storage/objects/media/7403645060262314021_transcode_video_mp4_540p_h264.mp4?x-muse-token=ChYIARABGJSUkrYGIJS3l7YGKgQzMjA0EpgBCg0InoCItrfntoZjEOxbEgAaAhgCIggKAmhsEgJjbioGCNo0EIYDMikKJ3siYml6X2lkIjoiMTAwMDAwMDAxIiwiZGVyaXZlZF91aWQiOiIifUIUChJpY2FyY2guaWFtLmF1dGhycGNKLi9hcGkvc3RvcmFnZS9vYmplY3RzL21lZGlhLzc0MDM2NDUwNjAyNjIzMTQwMjEa2AJUWkVaOU5GNUowQ3dzWUNmOGZnNXR0VGtQcnFpSVJkOTdYWkdjU2dVYmpwK3NxanpUTjZ4UXdqMEJ4MkZkZXJmRzVUSDBoL2lnUG9SUEh1OHhOTk1LYmFwaSttT1loMElXM0toZzdkdjdtSUM0QlM3MTBJbVRaUE51cGFNeko1NnZIaFRUWDlnN0k4T1c4ck05elFIVTJjWmh2QisyeTllTGVzTzJFOXpzaDk1cHNSWWVWbTBwMnlXZ3I0alJJblpzMk5jMUc5eDcvNHFqWko4M1c5TXlvaEJmcEpkaGhLZ1BNZGpyNWFVNWFlcWlVdlhIcTZMazNoODB6SStjQkZHbkd1L2M5YmRKU3h5ZnRmUnJnbnZ1RG14TEtrbjZCZWdPOG80UVNlM2RoRnhvbVU0S1VlTldQYTRQRS9FOGgxMGhIeDRJOHZCOE5kc0RnNFJ3aE4rTEE9PQ%3D%3D&infer_mime=ext",
                "Status": "Deny",
                "SlotNum": 11,
                "MaxSlotDuration": 4.092490911483765,
                "AspectRatio": "16:9",
                "Duration": 23.833,
                "CreateTime": "2024-08-16T08:01:04.446Z",
                "UpdateTime": "2024-08-20T12:47:01.772Z",
                "Creator": 7595288,
                "Updater": 1306736,
                "DemoCoverUrl": "https://photographer.iccvlog.com/api/storage/objects/media/7403647806399070218_transcode_image_jpeg_480p/abd30f53-72a8-4961-b832-1c32c3060e33_jpeg_480p.jpeg?x-muse-token=ChYIARABGJSUkrYGIJS3l7YGKgQzMjA0EqUBCg0InoCItrfntoZjEOxbEg0KC3ZvbGNfZW5naW5lGgIYAiIICgJsZhICY24qBgjaNBCGAzIpCid7ImJpel9pZCI6IjEwMDAwMDAwMSIsImRlcml2ZWRfdWlkIjoiIn1CFAoSaWNhcmNoLmlhbS5hdXRocnBjSi4vYXBpL3N0b3JhZ2Uvb2JqZWN0cy9tZWRpYS83NDAzNjQ3ODA2Mzk5MDcwMjE4GtgCWDlnZnkrK1pzelBFbXFtSXdTREZJK0s2UCttanIybnFleTAyRFRTSHFvNC8vOWIreXpNdlVtejAweFRSQWlzQUFXS1NmV3p0THpVVWdyeVlza2tTRXcrb2MwNHBud2YrWnhWN1BOVlRrOERSVDA2ZzJWR2hWdlhJaHJDUmNyU1RNUXpYNENLMmVnb1gzSUt1b2FPeHBZdFRuY1VLUFM4TXo3RC96bFNORFhweFE2bUtoZzhXNTF2ZVlVbVpMZFpnbVoybXJFT0ZhWHgvdlJUWjRtM0JML2ZPSkY1Zll6ZlUyMllTdFRmMFYyenpXV2FrQkNTendibEJxdWZaLytVclJrUzBxR2VhS0c4VXFSdDRPS0RWZHpZOTdRY1pnY2Z1OTJPKzlvLzlpRnFob2VocHdQeElJcTZPeXNrS2VqbWovRjBOUW9zVXVJSnJDNFlMTitLa0lnPT0%3D&infer_mime=ext",
                "DemoPreviewUrl": "https://photographer.iccvlog.com/api/storage/objects/media/7403647468510052367_transcode_video_mp4_480p_h264.mp4?x-muse-token=ChYIARABGJSUkrYGIJS3l7YGKgQzMjA0EqUBCg0InoCItrfntoZjEOxbEg0KC3ZvbGNfZW5naW5lGgIYAiIICgJsZhICY24qBgjaNBCGAzIpCid7ImJpel9pZCI6IjEwMDAwMDAwMSIsImRlcml2ZWRfdWlkIjoiIn1CFAoSaWNhcmNoLmlhbS5hdXRocnBjSi4vYXBpL3N0b3JhZ2Uvb2JqZWN0cy9tZWRpYS83NDAzNjQ3NDY4NTEwMDUyMzY3GtgCd3h3Ry91empja3ZlNHFkSTZQVGMwS2xYMjVxQmpCdzlZaGZnTmF5dHAvM3Q2blJxYnVJUHowcGY1WGpzdmliL0tmd1ZDYllDbHA0OWJMTFlFeUtia3B2anFESk1RbWpmbi9yVHVVeTR2VGd4YTdzdWxiVnpma0hkNTV2V3RmQzJvOUdpVVc5WG5pVDJMSkRJcWtHTkVvVm04QVVsL2g2UGVudm9qOHl4TElWQUZreHRKNVoyMGwySzA0Q1hpWUM0Zm9GdnFjQjBTblZuRURVVWpGMFhrYjkvZkpzTXZwZldFdHVFUWhteHNxMWtoTXNNdTVGN2kxL3NaRGFNT3ByeG5QdWN5d0c5b04zTjlwWWxBMklOMEFBR29QT3ZGS1FLQXUrbVdnajZJZ1YrWGdhcFRwNlZPeE9selVHN0VTcVZ6WjhyQ2xHWnpaOWNJUXkwelBZY3R3PT0%3D&infer_mime=ext",
                "SlotInfos": [
                    {
                        "Type": "aigc",
                        "Num": 2,
                        "MaxDuration": 2.2231
                    },
                    {
                        "Type": "preset",
                        "Num": 8,
                        "MaxDuration": 4.092490911483765
                    },
                    {
                        "Type": "position",
                        "Num": 3,
                        "MaxDuration": 0.4333310127258301
                    }
                ]
            }
        ]
    }
}