You need to enable JavaScript to run this app.
导航

图片处理持久化

最近更新时间2023.07.11 17:17:50

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

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

注意事项

  • 使用图片处理持久化的账号必须拥有原图所在桶的读权限,图片转存的目标桶的写权限。

  • 使用匿名用户将处理后的图片保存至指定的存储桶时,该存储桶必须为公共写权限。

  • 原图所在桶与图片转存的目标桶必须属于同一地域。

  • 转存图片的访问权限默认为私有,存储类型默认为标准存储。

参数说明

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

示例

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

  • 使用图片处理参数和持久化参数生成预签名链接,然后使用该预签名链接转存图片。关于使用 SDK 生成预签名链接的描述,请参见各个语言的预签名机制文档。
  • 使用图片 URL 访问和处理图片,在该图片 URL 基础上添加持久化参数,将图片转存至指定存储桶。该种方式为匿名访问,存储桶必须开启公共写权限,否则转存图片会失败。

注意

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

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

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

  • 将处理后的图片命名为 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

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

处理后的图片 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

  • 将处理后的图片命名为 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