文档中心

对象存储

请输入

基本概念

管道

管道（|）用于串联多个数据处理任务，无需手动传递中间结果，TOS 会按照管道定义的顺序依次执行数据处理任务，提高数据处理的效率。本文介绍管道的注意事项、串联规则和使用示例。

注意事项

仅支持使用管道（|）执行两种操作：串联图片处理和图片处理，串联视频截帧和图片处理，关于图片处理和视频截帧的详细介绍，请参见图片处理概述和视频截帧。

串联规则

管道功能的分隔符是竖线（|）。您可以通过竖线（|）在文件 URL 中串联多个数据处理任务，TOS 按照文件 URL 从左到右的顺序依次执行数据处理任务。具体串联规则说明如下：

| | | \

串联的任务类型	说明

图片处理和图片处理	使用管道符号串联多个图片处理操作时，串联的第二个以及后续的图片处理操作可以携带 `image/` 参数，也可以不携带 `image/` 参数。
	文件 URL 格式为 `x-tos-process=image/<图片处理参数>

视频截帧和图片处理	使用管道符号串联视频截帧和图片处理时，文件 URL 需要遵循以下规则：

	* 第一个数据处理操作必须是视频截帧。
	* 第二个数据处理操作只能是图片处理，且图片处理操作必须携带`image/` 参数。
	* 第三个以及后续数据处理操作只能是图片处理，可以携带 `image/` 参数，也可以不携带 `image/` 参数。

	文件 URL 格式为`x-tos-process=image/<视频截帧参数>

使用示例

示例一：串联图片缩放和图片水印
- 对图片进行缩放
  指定图片缩放宽度为 200，高度为 200，模式为 fixed。
  https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed
  ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cf25b5602d464ed0807acfa3d1f341b1~tplv-goo7wpa0wc-image.image =200x)
- 串联图片缩放和图片水印
  指定图片缩放宽度为 200，高度为 200，模式为 fixed，然后在图片上添加 Hello 的文字水印，文字大小设置为 72，颜色设置为红色，字体设置为方正书宋。
  https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed|watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw
  ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5a2c355800e7468885e44b9f9e4a28ba~tplv-goo7wpa0wc-image.image =200x)
示例二：串联视频截帧和图片旋转
- 使用视频截帧截取图片
  使用默认模式截取 26000ms 处的帧，缩放宽度 400 px、高度 200 px，且图片输出格式为 jpg。
  https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg
  ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/32c30a5c00b94814987498364dd9a871~tplv-goo7wpa0wc-image.image =400x)
- 串联视频截帧和图片旋转
  使用默认模式截取 26000ms 处的帧，缩放宽度 400 px、高度 200 px，且图片输出格式为 jpg，然后将图片顺时针旋转 90 度。
  https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg|image/rotate,90
  ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9aed5dbba02a4e7db73242cb86150acc~tplv-goo7wpa0wc-image.image =200x)

最近更新时间：2025.03.25 17:29:53

这个页面对您有帮助吗？

有用

无用