文档中心

对象存储

请输入

媒体处理

媒体处理概述

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

使用限制

类别	使用限制
格式	仅支持对部分视频编码格式和视频封装格式的视频执行视频处理操作，具体支持的格式说明如下：视频编码格式：MPEG-4 Part 2、HEVC、AVI、VP8、VP9、H264 和 H265。视频封装格式：avi、mp4、mkv、mov、webm、flv、ts。
QPS	媒体处理操作在每个地域的每秒请求数 QPS 的上限为 20。说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
并发	媒体处理操作在每个地域的并发值上限为 20。说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
服务端加密	支持对使用 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 两种使用方式。您可以对存储在存储桶中的视频进行视频截帧、获取视频元信息操作，并快速获取处理后的内容。

说明

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

使用 REST API，请求示例如下：

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

使用文件 URL

视频处理 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 的详细介绍，请参见以下文档：

Java SDK 预签名

Go SDK 预签名

C++ SDK 预签名

Python SDK 预签名

Node.js SDK 预签名

Browser.js SDK 预签名

.NET SDK 预签名

PHP SDK 预签名

视频处理功能

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

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

最近更新时间：2026.09.30 15:21:43

这个页面对您有帮助吗？

有用

无用