文档中心

图片处理持久化

最近更新时间：2024.02.26 20:41:42

首次发布时间：2023.05.22 16:04:59

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

注意事项

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

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

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

注意

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

将处理后的图片命名为 abc.png，并保存至原始图片所在桶，示例 URL 如下：
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100&x-tos-save-object=YWJjLnBuZw==
将处理后的图片命名为 abc.png，并保存至名为 arctic 的存储桶，示例 URL 如下：
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

将处理后的图片命名为 abc.png，并保存至原始图片所在桶，示例 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&x-tos-save-object=YWJjLnBuZw==
将处理后的图片命名为 abc.png，并保存至 arctic 存储桶，示例 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&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj

注意事项

参数说明

示例

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

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