## 功能描述此接口用于将视频文件转换为动图，并存储至指定存储桶。 ## 注意事项 * 视频封装格式：MP4/TS/MKV * 视频编码格式：H264/H265/VP8/VP9/AV1 * 视频分辨率限制：[128,4096] * 视频大小限制：视频长度不超过 15 分钟 ## 请求消息样式 ```HTTP // 对文件 example.mkv 进行视频转动图。 POST /example.mkv?x-tos-async-process HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 28 Oct 2024 06:40:10 GMT Authorization: TOS qn6q**************:77Dv**************** x-tos-async-process=video/animation,f_gif,w_100,h_100,inter_1000&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |x\-tos\-async\-process |Query |String |是 |\- |代表视频转动图请求的特殊标识。 | ## 请求元素 |**名称** |**参数类型** |**是否必填** |**示例值** |**说明** | |---|---|---|---|---| |ss |Int |否 |0 |视频转动图的起始时间，单位为毫秒。取值：|\ | | | | ||\ | | | | |* `0（默认值）`：从起始位置开始。|\ | | | | |* `大于0`：从第 **ss** 毫秒开始。 | |f |String |是 |gif |输出动图格式，取值：`gif`。 | |num |Int |否 |100 |动图帧数量，默认为不限制数量（抽帧到视频结束）。|\ | | | | |:::warning|\ | | | | |当视频长度不足时，实际抽帧数量会小于设定的参数值。|\ | | | | ||\ | | | | |:::| |inter |Int |否 |1 |动图抽帧间隔，单位为毫秒，默认抽取所有视频帧。|\ | | | | |:::warning|\ | | | | |当该参数小于源视频帧间隔（帧率倒数）时，会按源视频帧间隔进行抽帧。|\ | | | | ||\ | | | | |:::| |fps |Float |否 |30 |动图帧率，默认为 **inter** 倒数。取值范围为 [0, 240]。|\ | | | | |:::tip|\ | | | | |该参数控制动图的播放速度，当为默认值时与源视频播放速度一致。比默认值大将产生加速效果，比默认值小将产生减速效果。|\ | | | | ||\ | | | | |:::| |w |Int |否 |1024 |输出动图的宽度，单位为 px，取值范围为 [32,4096]。|\ | | | | |:::tip|\ | | | | |如果指定为 0，则按源视频的分辨率比例自动计算。|\ | | | | ||\ | | | | |:::| |h |Int |否 |1024 |输出动图的高度，单位为 px，取值范围为 [32,4096]。|\ | | | | |:::tip|\ | | | | |如果指定为 0，则按源视频的分辨率比例自动计算。|\ | | | | ||\ | | | | |:::| |scaletype |String |否 |crop |缩放方式。取值：|\ | | | | ||\ | | | | |* `crop`：缩放并裁剪。|\ | | | | |* `stretch`（默认值）：拉伸以填满。|\ | | | | |* `fill`：缩放并保留黑边。|\ | | | | |* `fit`：缩放并不保留黑边，等比缩放。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |status |String |OK |状态码。 | ## 请求示例 ```HTTP POST /example.mkv?x-tos-async-process HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 28 Oct 2024 06:40:10 GMT Authorization: TOS qn6q**************:77Dv**************** x-tos-async-process=video/animation,f_gif,w_100,h_100,inter_1000&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj ``` ## 响应示例 ```HTTP HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 0 { "status": "OK" } ```

对象存储