最近更新时间:2026-03-31 13:47:24
图片处理服务目前提供新旧两版服务,本文介绍两版服务的主要区别。旧版图片处理服务的功能后续将不会再更新,推荐您使用新版图片处理服务。
在添加处理参数时,新旧版本服务中的格式不同,区别如下:
旧版 | 新版 | ||||
操作 | 说明 | 样例 | 操作 | 说明 | 样例 |
imgScale | 缩放/裁剪 | https://BucketName.ks3-cn-beijing.ksyuncs.com/objectKey@base@ &h=<height> &cox=<x-coordinate> &coy=<y-coordinate> &et=<extent> &etw=<extentwidth> ð=<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://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 | 忽略错误 | |
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 | |||
纯净模式
