文档中心

视频处理概述

最近更新时间：2024.03.20 19:30:02

首次发布时间：2023.04.13 11:18:04

TOS 支持处理存储的视频文件，您可以通过 GetObject 接口，在请求中携带视频处理的相关参数。TOS 支持的视频处理功能包括视频截帧、获取视频元信息。

使用限制

类别	使用限制
视频编码	仅支持对视频编码格式为 MPEG-4 Part 2、HEVC、AVI、H264 和 H265 的视频文件进行视频截帧和查看视频信息。
QPS	图片处理和视频处理每秒请求数 QPS 限制如下：北京地域：20 其他地域：10
服务端加密	支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的视频进行处理，使用限制如下：对使用 SSE-C 加密的视频进行处理时，必须携带 SSE-C 的 `x-tos-server-side-encryption-customer-algorithm`、`x-tos-server-side-encryption-customer-key`、`x-tos-server-side-encryption-customer-key-MD5` 头域，关于 SSE-C 头域的详细介绍，请参见使用用户提供密钥的服务端加密（SSE-C）。不支持匿名处理经过 SSE-KMS 加密的视频，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名处理经过 SSE-KMS 加密的视频。您可以使用预签名、API 或 SDK 处理经过 SSE-KMS 加密的视频，关于视频处理的 API 和 SDK 详细介绍，请参见下文的使用 REST API 和视频截帧（Java SDK）。

类别

使用限制

视频编码

仅支持对视频编码格式为 MPEG-4 Part 2、HEVC、AVI、H264 和 H265 的视频文件进行视频截帧和查看视频信息。

QPS

图片处理和视频处理每秒请求数 QPS 限制如下：

服务端加密

支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的视频进行处理，使用限制如下：

对使用 SSE-C 加密的视频进行处理时，必须携带 SSE-C 的 x-tos-server-side-encryption-customer-algorithm、x-tos-server-side-encryption-customer-key、x-tos-server-side-encryption-customer-key-MD5 头域，关于 SSE-C 头域的详细介绍，请参见使用用户提供密钥的服务端加密（SSE-C）。
不支持匿名处理经过 SSE-KMS 加密的视频，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名处理经过 SSE-KMS 加密的视频。您可以使用预签名、API 或 SDK 处理经过 SSE-KMS 加密的视频，关于视频处理的 API 和 SDK 详细介绍，请参见下文的使用 REST API 和视频截帧（Java SDK）。

视频处理特性目前提供 REST API、文件 URL 两种使用方式。您可以对存储在存储桶中的视频进行视频截帧、获取视频元信息操作，并快速获取处理后的内容。

说明

处理后的视频会即时返回，不会保存到您的存储桶中。

GET /misc/video?x-tos-process=video/snapshot,t_30000 HTTP/1.1
Host: endpoint
X-Tos-Date: 20220827T132948Z
Authorization: authorization

视频处理 URL 由文件URL?x-tos-process=video/功能类别,参数名_参数值组成。如果视频处理 URL 中使用多个参数，需要用英文逗号（,）隔开。示例 URL 如下：

https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_30000

说明

对于私有视频，您需要使用 SDK 生成带视频处理参数的预签名 URL，再执行视频处理操作。关于各语言的预签名 URL 的详细介绍，请参见以下文档：

TOS 视频处理支持以下功能，当您在请求中指定多个参数时，TOS 将按照参数顺序依次对视频进行处理。

功能	参数	说明
视频截帧	snapshot	截取指定时刻的单帧画面并按指定大小缩放成图片。
获取视频信息	info	获取视频元信息。

使用限制

视频处理方式

视频处理功能