文档中心

对象存储

请输入

基本概念

另存为

TOS 默认不保存处理后的图片和视频。您可以在处理图片和视频的 URL 后添加持久化参数，将处理后的图片和视频保存至指定的存储桶。本文介绍另存为相关参数和使用示例。

注意事项

将图片和视频转存至指定的存储桶时，将默认继承存储桶的服务端加密方式，如果转存的存储桶默认加密方式为 SSE-KMS 加密，请确保当前账号拥有对应存储桶 KMS 密钥的权限。

参数说明

参数	参数说明	取值说明	是否必须
x-tos-save-object	处理后的图片和视频在目标桶中的名称。该名称必须进行 url 安全的 base64 编码。	base64 编码的字符串。	是
x-tos-save-bucket	处理后的图片和视频转存的目标桶名称。该名称必须进行 url 安全的 base64 编码。	base64 编码的字符串。默认为原图和视频所在存储桶。	否

示例

您可以使用以下两种方式转存图片：

使用图片 URL 访问和处理图片，在该图片 URL 基础上添加持久化参数，将图片转存至指定存储桶。该种方式为匿名访问，存储桶必须开启公共写权限，否则转存图片会失败。

注意

以下链接仅为示例，用于展示如何添加持久化参数。您没有示例链接存储桶的写权限，如果访问示例链接，将返回 AccessDenied。

对缩放后的图片进行持久化保存

处理后的图片 URL：https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100&x-tos-save-object=YWJjLnBuZw==

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj

对视频截帧截取的图片进行持久化保存

处理后的图片 URL：https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg

https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg&x-tos-save-object=YWJjLnBuZw==

https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj

最近更新时间：2026.10.13 10:13:19

这个页面对您有帮助吗？

有用

无用