视频裁剪
更新时间：2025-05-22 15:09:37
视频裁剪功能可去除视频画面中不需要的区域，聚焦特定关注区域。该操作可与其他流媒体处理任务在单次API调用中结合使用。
使用方法
在请求体中，请按照以下格式构造fops参数：
<op>/<format>
/gravity/<value>
/vcrop/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
必选参数
| 参数 | 说明 |
|---|---|
op |
操作类型。视频裁剪须设置为avthumb。 |
format |
输出的目标格式（如flv、mp4、m3u8）。 |
可选参数
| 参数 | 说明 |
|---|---|
gravity |
确定裁剪起始位置和方向。默认值：TOP_LEFT。 |
vcrop |
使用宽度和高度来定义裁剪区域尺寸。 |
saveas |
指定输出位置和文件名，需进行URL安全Base64编码：Urlsafe_Base64_Encode(bucket:savedfilename)。 |
视频偏移参数说明
gravity参数定义裁剪起始位置：
| 参数值 | 说明 |
|---|---|
TOP_LEFT |
从左上角开始（默认） |
TOP_CENTER |
从顶部边缘中点开始 |
TOP_RIGHT |
从右上角开始 |
CENTER_LEFT |
从左侧边缘中点开始 |
CENTER |
从画面正中心开始 |
CENTER_RIGHT |
从右侧边缘中点开始 |
BOTTOM_LEFT |
从左下角开始 |
BOTTOM_CENTER |
从底部边缘中点开始 |
BOTTOM_RIGHT |
从右下角开始 |
裁剪尺寸参数说明
vcrop参数控制裁剪区域尺寸：
| 格式 | 说明 |
|---|---|
<Width>x |
仅设置宽度，保持原始高度。范围：0-10,000。 |
x<Height> |
仅设置高度，保持原始宽度。范围：0-10,000。 |
<Width>x<Height> |
同时设置宽高。每个维度范围：0-10,000。 |
{vcropSize}a<dx>a<dy> |
从起始点向右移动dx像素，向下移动dy像素调整裁剪位置。 |
应用示例
本示例演示两种视频裁剪方式，生成两个独立输出文件：
- 从左上角裁剪生成400x352像素的m4a格式视频
- 从中心点裁剪生成200x352像素的flv格式视频
伪代码
curl -v -X POST
-d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/m4a/gravity/TOP_LEFT/vcrop/400x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.m4a);avthumb/flv/gravity/CENTER/vcrop/200x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.flv))&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
实际请求
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tNGEvZ3Jhdml0eS9UT1BfTEVGVC92Y3JvcC80MDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXROR0VLQ2c9PTthdnRodW1iL2Zsdi9ncmF2aXR5L0NFTlRFUi92Y3JvcC8yMDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNW1iSFlLQ2c9PQoK&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
本篇文档内容对您是否有帮助？
有帮助
我要反馈