功能描述

此接口用于查询多图截帧任务。

注意事项

使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:GetDataProcessJob 权限，再将该策略绑定至需要使用本功能的子账号。

请求消息样式

请求参数和消息头

名称	位置	参数类型	是否必选	示例值	说明
job_type	Query	String	是	VideoSnapshots	任务类型，多图截帧场景下取值仅为 VideoSnapshots。
job_id	Query	String	是	183535129563a53bfa710001887ae45a****	多图截帧任务的 ID。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
JobID	String	183535129563a53bfa710001887ae45a****	多图截帧任务的 ID。
CreateTime	String	2025-03-26T17:14:01+0800	多图截帧任务的创建时间。
StartTime	String	2025-03-26T17:14:02+0800	多图截帧任务开始执行的时间。
EndTime	String	2025-03-26T17:14:02+0800	多图截帧任务结束执行的时间。
State	String	Success	任务状态。
Code	String	0	状态码。
Message	String	Success	请求状态信息。
Input	Container	-	源文件。
Object	String	data.mp4	待多图截帧的视频文件。父节点：Input
SnapshotsConfig	Container	-	多图截帧任务的截帧配置。
Snapshots	Container	-	截帧配置。父节点：SnapshotsConfig
OutFormat	String	jpg	输出的图片格式。 jpg png mjpeg 父节点：Snapshots
Width	Integer	720	图片宽度，取值范围为 [128, 4096]。父节点：Snapshots
Height	Integer	128	图片高度，取值范围为 [128, 4096]。父节点：Snapshots
Mode	String	Interval	截帧模式，取值为 Interval 或 Index，表示按时间间隔截帧。父节点：Snapshots
Start	Integer	20000	截帧开始时间点，单位毫秒。父节点：Snapshots
Count	Integer	10	截帧数量，取值范围为 (0, 1000]。父节点：Snapshots
IndexList	Integer	[1000, 2000]	表示指定截帧时间点列表，Mode 为 Index 时必填，单位毫秒。父节点：Snapshots
OutMode	String	OnlySnapshot	截帧输出类型，取值仅为 OnlySnapshot，表示输出多张图片。父节点：Snapshots
TimeInterval	Integer	0	截帧间隔时间，单位：毫秒，取值单位为 [0, 3600000]。说明 TimeInterval 为 0 时，表示截取每帧画面。父节点：Snapshots
DHashThreshold	Integer	60	dHash 去重阈值，取值范围为 [0, 100]。当取值为 0 时表示未启用 dHash 去重。父节点：Snapshots
SnapshotsResult	Container	-	多图截帧的结果。
ObjectCount	Integer	3	多图截帧截取到的图片数量。父节点：SnapshotsResult
Output	Container	-	截取到的图片的存储配置。
Region	String	cn-beijing	图片的存储地域。父节点：Output
Bucket	String	test	存储图片的存储桶。父节点：Output
Object	String	example${Number}.jpg	图片的名称，支持按序号命名图片，例如设置 object 为example${Number}.jpg，则会自动按先后顺序使用递增序号命名图片，例如首个图片命名为 example1.jpg，第二张图片命名为 example2.jpg。父节点：Output

请求示例

响应示例

对象存储