## 功能描述此接口用于创建多图截帧任务，从视频流中按规定间隔时长截取多个单帧画面，并按指定大小缩放成图片。 ## 请求消息样式 ```Plain Text POST /?job_type=VideoSnapshots&media_jobs HTTP/1.1 Host: .tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: Content-Type: application/json { "Input" : { "Object" : "sample.mp4" }, "SnapshotsConfig": { "Snapshots": { "OutFormat": "jpg", "Width": 720, "Height": 0, "Mode": "Interval", "Start": 20000, "Count": 10, "TimeInterval": 0 "DHashThreshold": 60 } }, "Output" : { "Region" : "cn-beijing", "Bucket" : "testbkt", "Object" : "example${Number}.jpg" } } ``` ## 请求参数和消息头 |名称 |位置 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---|---| |media_jobs |Query |String |是 |\- |代表媒体任务的请求特殊标识。 | |job_type |Query |String |是 |VideoSnapshots |任务类型，多图截帧场景下取值仅为

`VideoSnapshots`。 | ## 请求元素 |名称 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---| |Input |String |是 |\- |源文件。 | |Object |String |是 |data.mp4 |待多图截帧的源视频文件。

父节点：`Input` | |SnapshotsConfig |String |是 |\- |多图截帧任务的截帧配置。 | |Snapshots |String |是 |\- |截帧配置。

父节点：`SnapshotsConfig` | |OutFormat |String |是 |jpg |输出图片格式,取值如下：

* jpg

* png

父节点：`Snapshots` | |Width |Integer |否 |720 |图片宽度，取值范围为 [128, 4096]。

说明

*

如果只设置 Width ，将按照视频原始比例计算图片的高度。

*

如果只设置 Height ，将按照视频原始比例计算图片的宽度。

*

如果未指定Width和Height ，则表示将按原视频宽高输出图片。

说明

TimeInterval 为 0 时，表示截取每帧画面。

父节点：`Snapshots` | |DHashThreshold |Integer |否 |60 |dHash去重阈值，取值范围为 [0, 100]。

设置后，截帧时会计算相邻帧之间的dHash感知哈希距离，距离小于阈值的帧将被跳过不输出，从而去除视觉上重复的帧。

值为 `0` 时表示不启用dHash去重。

父节点：`Snapshots` | |Output |String |是 |\- |截取到的图片的存储配置。 | |Region |String |是 |cn\-beijing |图片的存储地域。

父节点：`Output` | |Bucket |String |是 |test |存储图片的存储桶。

父节点：`Output` | |Object |String |是 |example${Number}.jpg |图片的名称，支持按序号命名图片，例如设置 object 为`example${Number}.jpg`，则会自动按先后顺序使用递增序号命名图片，例如首个图片命名为 example1.jpg，第二张图片命名为 example2.jpg。

父节点：`Output` | ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 ## 响应元素 |名称 |参数类型 |示例值 |说明 | |---|---|---|---| |Code |String |OK |状态码。 | |Message |String |Success |请求状态信息。 | |JobId |String |183535129563a53bfa710001887ae45ac629 |多图截帧任务 ID。 | ## 请求示例 ```Plain Text POST /?job_type=VideoSnapshots&media_jobs HTTP/1.1 Host: .tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: Content-Type: application/json { "Input" : { "Object" : "sample.mp4" }, "SnapshotsConfig": { "Snapshots": { "OutFormat": "jpg", "Width": 720, "Height": 0, "Mode": "Interval", "Start": 20000, "Count": 10, "TimeInterval": 0 "DHashThreshold": 60 } }, "Output" : { "Region" : "cn-beijing", "Bucket" : "testbkt", "Object" : "example${Number}.jpg" } } ``` ## 响应示例 ```Plain Text HTTP/1.1 204 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 { "Code": "OK", "Message": "Success", "JobId": "183535129563a53bfa710001887ae45ac629" } ```

对象存储