接口4：获取成片--创意互动Vlog-火山引擎

文档中心

创意互动Vlog

API参考

接口4：获取成片

接口4：获取成片

描述

查询景区成片数据，可指定任务ID，查某次任务的成片。

Action

ListFilms

入参

字段	类型	是否必填	描述
ScenicSpotId	string	否	景区ID。
TaskId	string	否	任务ID。
Status	string	否	状态，可选值： Processing 处理中 Finished 成功 Failure 失败未填，表示不限制任务状态。
PageNumber	Integer	否	页码默认值1。
PageSize	Integer	否	每页数量默认值10。

出参

字段	类型	允许为空	描述
TotalCount	int64	否	用户的成片总数。
Films	[]Film	否	成片列表。

Film 成片信息

字段	类型	允许为空	描述
ScenicSpotId	string	否	景区ID。
Status	string	否	状态，取值范围： Processing 处理中； Finished 成功； Failure 失败。
Message	string	是	状态为失败，该字段将返回失败原因。
TaskId	string	是	合成任务ID。
VideoId	string	是	视频ID。
Name	string	是	成片名称。
VideoUrl	string	是	视频链接，有效期24h，过期可重新查询。
CoverUrl	string	是	封面链接，有效期24h，过期可重新查询。
Duration	float64	是	视频时长，单位秒，精确到毫秒。
Size	int64	是	视频大小，单位Byte。
CreateTime	string	否	成片创建时间，ISO时间格式。如 2022-12-20T08:00:00+08:00
FinishTime	string	是	成片完成时间，ISO时间格式。如 2022-12-20T09:05:00+08:00

说明：

提交任务后，成片进入处理中（Processing）状态；
合成完成为成功（Finished）状态；
任务异常为失败（Failure）状态，若成片失败，可查看失败原因，并重新发起成片。

最近更新时间：2024.08.23 10:23:54

这个页面对您有帮助吗？

有用

有用

无用

无用