全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

新旧版本图片处理服务及使用说明

最近更新时间:2026-03-31 13:47:24

图片处理服务目前提供新旧两版服务,本文介绍两版服务的主要区别。旧版图片处理服务的功能后续将不会再更新,推荐您使用新版图片处理服务。


新旧版本图片处理服务的主要区别

在添加处理参数时,新旧版本服务中的格式不同,区别如下:

旧版

新版

操作

说明

样例

操作

说明

样例

imgScale

缩放/裁剪

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@
tag=imgScale
&m=<mode>
&w=<width>

&h=<height>
&c=<cut>
&f=<fixed>

&cox=<x-coordinate>

&coy=<y-coordinate>

&et=<extent>

&etw=<extentwidth>

&eth=<extentheight>

&etc=<extentcolour>

resize

缩放

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=

image/resize,

m_<mode>,

p_<persent>,

w_<width>,

h_<height>,

l_<longSide>,

s_<shortSide>,

color_<color>,

limit_<limit>

格式转换

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&F=<format>

format

格式转换

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/format,<format>

质量变换

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&q=<quality>

&F=jpg

quality

质量变换

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/quality,q_<quality>,Q_<quality>

渐进显示

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&F=jpg

&interlace=1

interlace

渐进显示

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/format,jpg/interlace,1

去除图片元信息

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&s=<strip>

strip

去除图片元信息

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/strip

旋转

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&r=2

&rotate=<degree>

rotate

旋转

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/rotate,<value>

自适应方向

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&r=1

auto-orient

自适应方向

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/auto-orient,<value>

锐化

https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@

tag=imgScale

&sps=<value>

&spr=<value>

sharpen

锐化

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/sharpen,<value>

imageinfo

图片基本信息

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@tag=imageInfo

info

图片信息

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/info

exif

图片EXIF信息

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@tag=exif

imgAve

图片平均色

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@tag=imgAve

average-hue

图片平均色

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/average-hue

imgWaterMark

文字水印

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@

tag=imgWaterMark

&type=2

&text=<base64EncodeText>

&font=<base64EncodeFont>

&fontsize=<fontsize>

&fill=<base64EncodeFill>

&dissolve=<dissolve>

&gravity=<gravity>

&dx=<offsetX>

&dy=<offsetY>

watermark

文字水印

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/watermark,

t_<transparent>,

g_<gravity>,

x_<xoffset>,

y_<yoffset>,

fill_<value>,

padx_<padx>,

pady_<pady>,

text_<text>,

type_<fonttype>,

color_<color>,

size_<size>,

rotate_<value>

图片水印

https://BucketName.ks3-cn-beijing.ksyuncs.com/object@base@

tag=imgWaterMark

&type=1

&dissolve=<dissolve>

&gravity=<gravity>

&image=<base64EncodeImageURI>

&dx=<offsetX>

&dy=<offsetY>

&wtw=<width>

&wth=<height>

图片水印

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/watermark,

t_<transparent>,

g_<gravity>,

x_<xoffset>,

y_<yoffset>,

fill_<value>,

padx_<padx>,

pady_<pady>,

image_<image>

图文混排

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@

tag=imgWaterMark

&type=2

&text=<base64EncodeText>

&font=<base64EncodeFont>

&fontsize=<fontsize>

&fill=<base64EncodeFill>

&dissolve=<dissolve>

&gravity=<gravity>

&dx=<offsetX>

&dy=<offsetY>

|tag=imgWaterMark

&type=1

&dissolve=<dissolve>

&gravity=<gravity>

&image=<base64EncodeImageURI>

&dx=<offsetX>

&dy=<offsetY>

&wtw=<width>

&wth=<height>

图片混排

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/watermark,

t_<transparent>,

g_<gravity>,

x_<xoffset>,

y_<yoffset>,

fill_<value>,

padx_<padx>,

pady_<pady>,

text_<text>,

type_<fonttype>,

color_<color>,

size_<size>,

rotate_<value>,

image_<image>,

order_<order>,

align_<align>,

interval_<interval>

ignoreError

忽略报错

https://BucketName.endpoint/object@base@tag=imgScale&w=100|tag=ignoreError

ignore-error

忽略错误

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/resize,w_<width>/ignore-error,1

flip

镜像翻转

https://<bucketName>.<endpoint>/<objectKey>@base@tag=flip&v=<value>

flip

镜像翻转

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/flip,<value>

crop

自定义裁剪

https://<bucketName>.<endpoint>/<objectKey>@base@

tag=crop

&g=<gravity>

&w=<width>

&h=<height>

&x=<offsetX>

&y=<offsetY>

crop

自定义裁剪

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/crop,

g_<gravity>,

h_<height>,

w_<width>,

x_<xoffset>,

y_<yoffset>

imgCircle

内切圆

https://BucketName. ks3-cn-beijing.ksyuncs.com/object@base@

tag=imgCircle

&i=<radio>

&F=<format>

circle

内切圆

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/circle,r_<radius>

indexCrop

索引切割

GET /{ObjectKey}@base@

tag=indexCrop

&x=<width>

&y=<height>

&i=<index>

indexcrop

索引切割

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/indexcrop,

x_<width>,

y_<height>,

i_<index>

roundedCorners

圆角矩形

https://<bucketName>.<endpoint>/<objectKey>@base@

tag=roundedCorners

&r=<radius>

&F=<format>

rounded-corners

圆角矩形

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/rounded-corners,

r_<radius>,

rx_<x-radius>,

ry_<y-radius>

blur

模糊

https://<bucketName>.<endpoint>/<objectKey>@base@

tag=blur

&r=<radius>

&s=<sigma>

&w=<width>

&h=<height>

&x=<offsetX>

&y=<offsetX>

blur

模糊

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/blur,

r_<radius>,

s_<standard_deviation>,

w_<width>,

h_<height>,

x_<xoffset>,

y_<yoffset>

colorspace

灰度

https://<bucketName>.<endpoint>/<objectKey>@base@

tag=colorspace

&v=gray

colorspace

灰度

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/colorspace,gray

saveas

持久化

POST /{Objectkey}?x-kss-process HTTP/1.1

Host:{BucketName}.{endpoint}

Content-Length: {Content-Length}

Date: {date}

Authorization: {SignatureValue}

x-kss-process=image@base@tag=(图片处理操作)|tag=saveas&o=&b=(转存操作)

saveas

持久化

POST https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss HTTP/1.1

Host:{BucketName}.{endpoint}

Content-Length: {Content-Length}

Date: {date}

Authorization: {SignatureValue}

x-kss-procss=image/colorspace,gray|sys/saveas,b_<bucket>,o_<objectkey>

bright

亮度

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/bright,<value>

contrast

对比度

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/constrast,<value>

imageslim

图片瘦身

https://bucket.ks3-cn-beijing.ksyuncs.com/objectKey?x-kss-procss=image/imageslim

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈