金山云-文档中心-自定义裁剪

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

用户指南

图片处理

图片处理操作

自定义裁剪

最近更新时间：2025-11-07 14:46:46



接口

crop

描述

可以指定图片中任意位置为起点，裁剪出任意大小的矩形区域。

说明

权限说明
- 该接口操作需要是Bucket Owner或具有ks3:GetObject权限。
参数值超出范围
- 如果指定的裁剪起点坐标超过原图边界，将会返回 InvalidArgument 错误。
- 如果指定的裁剪宽度或高度超过原图边界，则会裁剪到原图边界。

请求

请求语法

https://<bucketName>.<endpoint>/<objectKey>@base@tag=crop&w=<width>&h=<height>&x=<offsetX>&y=<offsetY>&g=<gravity>

请求参数

参数名称	参数含义	是否必填	取值范围
tag	操作标志	是	crop
w	裁剪宽度	否	[0, 图片宽度]，默认为图片宽度
h	裁剪高度	否	[0, 图片高度]，默认为图片高度
x	裁剪起点横坐标，默认左上角为原点	否	[0, 图片宽度]，默认为0
y	裁剪起点纵坐标，默认左上角为原点	否	[0, 图片高度]，默认为0
g	裁剪原点位置，其可选位置遵循九宫格分布	否	• NorthWest：左上（默认值） • North：中上 • NorthEast：右上 • West：左中 • Center：中部 • East：右中 • SouthWest：左下 • South：中下 • SouthEast：右下不区分大小写，各取值的计算方法参见计算方法

各裁剪原点位置的计算方法如下，其中srcW代表原图宽度，srcH代表原图高度。

裁剪原点	位置计算方法
NorthWest	0, 0
North	srcW/2 - w/2, 0
NorthEast	srcW - w, 0
West	0, srcH/2 - h/2
Center	srcW/2 - w/2, srcH/2 - h/2
East	srcW - w, srcH/2 - h/2
SouthWest	0, srcH - h
South	srcW/2 - w/2, srcH - h
SouthEast	srcW - w, srcH - h

请求头部

该请求不需要设置特殊的头部。

响应

响应头部

头部名称	是否必填	说明
Content-Type	是	MIME类型，成功时为图片固定的MIME类型image/*，失败时为application/json

响应内容

如果请求处理成功，返回图片的二进制图片数据。
如果请求失败，则返回如下JSON格式的内容：

{
    "code":  <code String>,
    "message":  <ErrorMessage String>,
    "requestId":  <requestId String>
}

特殊错误

HTTP状态码	描述
400	请求参数错误请求的文件不是图片或者是KS3不支持的图片格式
403	签名不匹配或无操作对应权限
404	请求的资源不存在
500	服务器端操作失败。如果遇到此种错误，请及时联系我们

示例

原图

指定起点裁剪

处理参数如下：
- 操作参数：crop
- 设置裁剪起点为（100，50）

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=crop&x=100&y=50

目标图

指定起点和宽高裁剪

处理参数如下：
- 操作参数：crop
- 设置裁剪起点为（100，50）
- 设置裁剪宽度为100px，高度为100px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=crop&x=100&y=50&w=100&h=100

目标图

文档导读

上一篇：忽略报错

下一篇：圆角矩形

纯净模式常规模式

纯净模式

点击可全屏预览文档内容