文档中心

对象存储

多图截帧

CreateVideoSnapshotsJob

CreateVideoSnapshotsJob

功能描述

此接口用于创建多图截帧任务，从视频流中按规定间隔时长截取多个单帧画面，并按指定大小缩放成图片。

注意事项

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

请求消息样式

请求参数和消息头

名称	位置	参数类型	是否必选	示例值	说明
media_jobs	Query	String	是	-	代表媒体任务的请求特殊标识。
job_type	Query	String	是	VideoSnapshots	任务类型，多图截帧场景下取值仅为 VideoSnapshots。

请求元素

名称	参数类型	是否必选	示例值	说明
Input	Object	是	-	源文件。
Object	String	是	data.mp4	待多图截帧的源视频文件。父节点：Input
SnapshotsConfig	Object	是	-	多图截帧任务的截帧配置。
Snapshots	Object	是	-	截帧配置。父节点：SnapshotsConfig
OutFormat	String	是	jpg	输出图片格式,取值如下： jpg png mjpeg 父节点：Snapshots
Width	Integer	否	720	图片宽度，取值范围为 [128, 4096]。说明如果只设置 Width ，将按照视频原始比例计算图片的高度。如果只设置 Height ，将按照视频原始比例计算图片的宽度。如果未指定Width和Height ，则表示将按原视频宽高输出图片。父节点：Snapshots
Height	Integer	否	128	图片高度，取值范围为 [128, 4096]。父节点：Snapshots
Mode	String	否	Interval	截帧模式，取值如下： Interval：默认值，按时间间隔截帧。 Index：按指定时间点截帧，此时需设置 IndexList。不传时自动按 Interval（按时间间隔截帧）处理。父节点：Snapshots
Start	Integer	否	20000	截帧开始时间点，单位毫秒。默认值为 0；不传时从视频起始位置（0ms）开始截帧。父节点：Snapshots
Count	Integer	是	10	截帧数量，取值范围为 (0, 1000]。父节点：Snapshots
IndexList	Integer	否	[1000, 2000]	表示指定截帧时间点列表，单位毫秒，Mode 为 Index 时必填。父节点：Snapshots
OutMode	String	否	OnlySnapshot	截帧输出类型，取值仅为 OnlySnapshot，表示输出多张图片。默认值为 OnlySnapshot；不传时自动按默认值处理。父节点：Snapshots
TimeInterval	Integer	否	0	截帧间隔时间，单位：毫秒，取值范围为 [0, 3600000]。 TimeInterval 不传时，取值为 0 ，表示截取每帧画面。父节点：Snapshots
DHashThreshold	Integer	否	60	dHash 去重阈值，取值范围为 [0, 100]。设置后，截帧时会计算相邻帧之间的 dHash 感知哈希距离，距离小于阈值的帧将被跳过不输出，从而去除视觉上重复的帧。默认值为 0 ，取值为 0 或不传时表示不启用 dHash 去重。父节点：Snapshots
Output	Object	是	-	截取到的图片的存储配置。
Region	String	是	cn-beijing	图片的存储地域。父节点：Output
Bucket	String	是	test	存储图片的存储桶。父节点：Output
Object	String	是	example${Number}.jpg	图片的名称，支持按序号命名图片，例如设置 object 为example${Number}.jpg，则会自动按先后顺序使用递增序号命名图片，例如首个图片命名为 example1.jpg，第二张图片命名为 example2.jpg。父节点：Output

响应消息头

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

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。
Message	String	Success	请求状态信息。
JobId	String	183535129563a53bfa710001887a********	多图截帧任务 ID。

请求示例

响应示例

最近更新时间：2026.10.16 18:33:16

这个页面对您有帮助吗？

有用

有用

无用

无用