diff --git a/docs/ext-storage/dev.md b/docs/ext-storage/dev.md
index 16de02c674475d0d4a8a69a65bdf0992eb24054f..da24548e6898e9191fbc2a31127c4efcb80a82e5 100644
--- a/docs/ext-storage/dev.md
+++ b/docs/ext-storage/dev.md
@@ -30,7 +30,7 @@ const extStorageManager = uniCloud.getExtStorageManager({
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|provider |String |是 |- |扩展存储供应商，可选
qiniu: 七牛云|
|domain |String |是 |- |扩展储存域名（域名地址）如：example.com |
@@ -71,14 +71,14 @@ module.exports = {
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|cloudPath |String |否 |- |云端文件路径（不填会自动生成） |
|allowUpdate |Boolean |否 | false |是否允许覆盖更新 true：可覆盖 false：仅新增，不可覆盖 |
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|uploadFileOptions|Object |uni.uploadFile所需的参数 |
|cloudPath |String |文件云端路径 |
|fileID |String |文件ID |
@@ -174,7 +174,7 @@ console.log('uploadFile: ', res);
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|fileContent|Buffer |是 |- |文件内容 |
|cloudPath |String |否 |- |云端文件路径（不填会自动生成） |
|allowUpdate |Boolean|否 | false |是否允许覆盖更新 true：可覆盖 false：仅新增，不可覆盖|
@@ -182,7 +182,7 @@ console.log('uploadFile: ', res);
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|cloudPath |String |文件云端路径 |
|fileID |String |文件ID |
|fileURL |String |文件URL（如果是私有权限的文件，则此URL是无法直接访问的） |
@@ -212,19 +212,19 @@ return res;
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|fileList |Array |是 |- |文件地址列表，数组内元素值类型支持（fileID、cloudPath、fileURL）
如："qiniu://test.jpg" "test.jpg" "https://example.com/test.jpg" 均表示同一个文件 |
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|fileList |Array |存储下载链接的数组 |
响应参数中的fileList
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|tempFileURL|String |临时文件URL地址|
|fileID |String |文件ID |
|cloudPath |String |文件云端路径 |
@@ -254,13 +254,13 @@ return res;
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|fileID |String |是 |- |待下载的文件，该字段支持的值类型：fileID、cloudPath、fileURL
如："qiniu://test.jpg" "test.jpg" "https://example.com/test.jpg" 均表示同一个文件 |
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|fileContent |Buffer |下载的文件的内容 |
@@ -287,13 +287,13 @@ return res;
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|fileList |Array |是 |- |文件地址列表，数组内元素值类型支持（fileID、cloudPath、fileURL）
如："qiniu://test.jpg" "test.jpg" "https://example.com/test.jpg" 均表示同一个文件 |
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|fileList |Array|删除结果组成的数组。 |
### 修改文件状态@updateFileStatus
@@ -322,7 +322,7 @@ return res;
#### 请求参数
|参数名 |类型 |必填 |默认值 |说明 |
-|:-: |:-: |:-: |:-: |:-: |
+|:-: |:-: |:-: |:-: |:- |
|fileID |String |是 |- |待修改的文件，该字段支持的值类型：fileID、cloudPath、fileURL
如："qiniu://test.jpg" "test.jpg" "https://example.com/test.jpg" 均表示同一个文件 |
|isPrivate|Boolean|是 |- |true 设为私有权限 false 设为公共读权限 |
@@ -330,7 +330,7 @@ return res;
#### 响应参数
|字段 |类型 |说明 |
-|:-: |:-: |:-: |
+|:-: |:-: |:- |
|errCode |Number |0 成功 其他均为失败|
|errMsg |String |失败描述|
@@ -350,6 +350,1501 @@ https://upload.qiniup.com
下载域名就是你开通扩展存储时绑定的自定义域名，将你的自定义域名添加到download合法域名列表中
+## 图片处理@imageshandle
+
+### 图片瘦身@imageslim
+
+**简介**
+
+图片瘦身服务（imageslim）在尽可能不影响画质的情况下，将JPEG、PNG格式的图片实时压缩，瘦身后画质基本没有变化，分辨率不变，格式不变，大幅缩小文件体积：
+
+- 降低CDN分发成本
+- 加快客户端图片的加载速度，提升用户体验
+
+**使用限制**
+
+- 原图限制
+ - 格式支持： JPEG、PNG 格式
+ - 对图片大小/分辨率没有限制，处理异常（处理超时、处理后图片大小大于原图、处理出错等）则返回原图
+- jpeg 图片瘦身
+ - 同步请求超时限制为 1s
+ - 异步请求的超时限制为 10s
+- png 图片瘦身
+ - 同步请求超时限制为 3s
+ - 异步请求的超时限制为 30s
+- 建议「图片瘦身」操作放在所有其他图片处理操作之后
+- 如果原图本身大小并不大，使用图片瘦身后可能没有瘦身效果，反而会增大
+
+**接口规格**
+
+```
+imageslim/zlevel/
+```
+
+|参数名称 |必填 |说明 |
+|:- |:- |:- |
+| `/zlevel/` |否 |图片质量损失控制，值越小，质量越好，压缩率越低。默认值为3，取值范围：[0-10]。 |
+
+**使用示例**
+
+原图
+
+```
+http://7xkv1q.com1.z0.glb.clouddn.com/grape.jpg
+```
+
+瘦身后
+
+```
+http://7xkv1q.com1.z0.glb.clouddn.com/grape.jpg?imageslim
+```
+
+瘦身后并控制质量损失
+
+```
+http://7xkv1q.com1.z0.glb.clouddn.com/grape.jpg?imageslim/zlevel/2
+```
+
+**瘦身前后图片对比**
+
+- 画质基本不变
+- 格式不变
+- 分辨率不变
+- 图片文件体积大幅减少，有助于节省 CDN 流量、提升用户体验
+
+
+
+### 图片基本处理@imageView2
+
+|功能 |说明 |
+|:- |:- |
+|缩略 |等比缩放、设定目标宽高缩放等多种方式 |
+|格式转换 |格式转换、GIF 颜色控制 |
+|渐进显示 |图片渐进显示 |
+|质量变换 |对图片质量进行调节 |
+
+**限制说明**
+
+使用服务时有如下限制：
+
+- 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
+ - webp动图，仅支持持久化处理
+- 输出限制
+ - 输出为 `gif`，一般处理时间比较长，建议优先使用持久化处理
+ - 输出为 `webp` 时，宽或高不能超过16383
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符
+
+```
+imageView2//w/
+ /h/
+ /format/
+ /interlace/
+ /q/
+ /colors/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:- |:- |:- |
+|/mode #{rowspan=7} |是#{rowspan=7} |定义等比缩放、设定目标宽高缩放的多种不同方式，取值范围：[0,5]的整数，必填项。分为如下几种情况： |
+|mode=0，使用姿势：`/0/w//h/`
1、限定缩略图的长边最多为``，短边最多为 ``，进行等比缩放，不裁剪。
2、如果只指定 w 参数则表示限定长边（短边自适应），只指定 h 参数则表示限定短边（长边自适应）。 |
+|mode=1，使用姿势：`/1/w//h/ `
1、限定缩略图的宽最少为``，高最少为``，进行等比缩放，居中裁剪。
2、转后的缩略图通常恰好是 `x` 的大小（有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分）。
3、如果只指定 w 参数或只指定 h 参数，代表限定为长宽相等的正方图。 | |
+|mode=2，使用姿势：`/2/w//h/`
1、限定缩略图的长边最少为``，短边最少为``，进行等比缩放，不裁剪。
2、如果只指定 w 参数则表示限定宽（高自适应），只指定 h 参数则表示限定高（宽自适应）。
3、它和模式0类似，区别只是限定宽和高，不是限定长边和短边。从应用场景来说，模式0适合移动设备上做缩略图，模式2适合PC上做缩略图。 | |
+|mode=3，使用姿势：`/3/w//h/ `
1、限定缩略图的长边最少为``，短边最少为``，进行等比缩放，不裁剪。
2、如果只指定 w 参数或只指定 h 参数，代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。 | |
+|mode=4，使用姿势：`/4/w//h/`
1、限定缩略图的长边最少为``，短边最少为``，进行等比缩放，不裁剪。
2、如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看（把这里的长边短边分别设为手机屏幕的分辨率即可），生成的图片尺寸刚好充满整个屏幕（某一个边可能会超出屏幕）。 | |
+|mode=5，使用姿势：`/5/w//h/ `
1、限定缩略图的长边最少为``，短边最少为``，进行等比缩放，居中裁剪。
2、如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。同上模式4，但超出限定的矩形部分会被裁剪。 | |
+| `/format/` |否 |图片输出格式
1、取值：copy，保持原图格式输出。
2、取值：jpg，gif，png，webp等，参考支持转换的图片格式。
3、取值：heic 或 avif ，属于 图片高级压缩 格式，按照图片高级压缩收费，当前仅支持 持久化处理 来使用。
注意：
● 必须指定mode参数，否则不生效。
● 当原图为heic 或 avif 时，设置format/copy 会保持原图格式不变，且不按照图片高级压缩收费；如果不指定 format 参数，将会输出jpeg 。 |
+| `/colors/` |否 |控制图片颜色数量
● 源图片为 GIF 时，控制输出 GIF 中不同颜色的数量，取值可为2、4、8、16、32、64、128、256，不使用该参数时的默认值为128。
● 输出图片为 PNG 时，控制输出 PNG 中不同颜色的数量，取值可为2、4、8、16、32、64、128、256，不使用该参数时默认关闭。
注意：
● 必须指定mode参数，否则不生效。
● 如果只设置图片颜色数量，不做其他缩放处理，建议使用 图片高级处理-格式转换 |
+| `/interlace/` |否 |是否支持渐进显示
取值范围：1 支持渐进显示，0不支持渐进显示(默认为0)。
适用目标格式：jpg
效果：网速慢时，图片显示由模糊到清晰。新图的输出格式，必须指定mode参数，否则不生效。
注意：
● 必须指定mode参数，否则不生效。
● 如果只设置渐渐显示，不做其他缩放处理，建议使用 图片高级处理-渐进显示 |
+| `/q/` |否 |新图的图片质量
● 取值范围是[1, 100]
● 输入是 jpeg，且不强制指定质量条件下，七牛会根据原图质量算出一个修正值，取修正值和指定值中的小值。
注意：
● 必须指定mode参数，否则不生效。
● 指定值后面可以增加 !，表示强制使用指定值，如100!。
● heic：默认值35
● avif：默认值50
● 其他格式：默认值75
● 如果只设置图片质量，不做其他缩放处理，建议使用 图片高级处理-质量变换 |
+| `/ignore-error/` |否 |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息。
注意：
● 必须指定mode参数，否则不生效。 |
+
+**注意：**
+
+- 所有模式都可以只指定w参数或只指定h参数，并获得合理结果。在w、h为限定最大值时，未指定某参数等价于将该参数设置为无穷大（自适应）；在w、h为限定最小值时，未指定参数等于给定的参数，也就限定的矩形是正方形。
+- 新图的宽/高/长边/短边，不会比原图大，即本接口总是 缩小图片。
+- 如果原图带有EXIF信息且包含Orientation字段且不能被识别出来，imageView2默认根据此字段的值进行自动旋转修正。
+- 当一张含有透明区域的图片，转换成不支持透明的格式jpg,bmp等时，透明区域填充白色。
+- ``修正值算法：
+ - 原图 quality <= 90：min[90, 原图quality*sqrt（原图长宽乘积/结果图片长宽乘积）]
+ - 原图 quality > 90： 原图quality*sqrt（原图长宽乘积/结果图片长宽乘积)
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+裁剪正中部分，等比缩小生成200x200缩略图：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200
+```
+
+
+
+宽度固定为200px，高度等比缩小，生成200x133缩略图：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/w/200
+```
+
+
+
+高度固定为200px，宽度等比缩小，生成300x200缩略图：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/h/200
+```
+
+
+
+设置图片质量为55：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200/q/55
+```
+
+
+
+### 图片高级处理@imageMogr2
+
+#### 缩放
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/thumbnail/!p
+ /thumbnail/!px
+ /thumbnail/!xp
+ /thumbnail/x
+ /thumbnail/x
+ /thumbnail/x
+ /thumbnail/!xr
+ /thumbnail/x!
+ /thumbnail/x>
+ /thumbnail/x<
+ /thumbnail/@
+ /ignore-error/
+```
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/thumbnail/!p` | |基于原图的长宽，按指定百分比缩放。Scale取值范围1-999。 |
+| `/thumbnail/!px` | |以百分比形式指定目标图片宽度，高度不变。Scale取值范围1-999。|
+| `/thumbnail/!xp` | |以百分比形式指定目标图片高度，宽度不变。Scale取值范围1-999。|
+| `/thumbnail/x` | |指定目标图片宽度，高度等比缩放，Width取值范围1-9999。 |
+| `/thumbnail/x` | |指定目标图片高度，宽度等比缩放，Height取值范围1-9999。 |
+| `/thumbnail/x` | |等比缩放，比例值为宽缩放比和高缩放比的较小值，Width 和 Height 取值范围1-9999。
注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高|
+| `/thumbnail/!xr` | |等比缩放，比例值为宽缩放比和高缩放比的较大值，Width 和 Height 取值范围1-9999。
注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高|
+| `/thumbnail/x!` | |按指定宽高值强行缩略，可能导致目标图片变形，width和height取值范围1-9999。|
+| `/thumbnail/x>` | |等比缩小，比例值为宽缩放比和高缩放比的较小值。如果目标宽和高都大于原图宽和高，则不变，Width 和 Height 取值范围1-9999。
注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高;|
+| `/thumbnail/x<` | |等比放大，比例值为宽缩放比和高缩放比的较小值。如果目标宽(高)小于原图宽(高)，则不变，Width 和 Height 取值范围1-9999。
注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高;|
+| `/thumbnail/@` ||按原图高宽比例等比缩放，缩放后的像素数量不超过指定值，Area取值范围1-24999999。 |
+| `/ignore-error/` ||主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息 |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+等比缩小至 20%
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!20p
+```
+
+
+
+等比缩小到宽为200px
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x
+```
+
+
+
+等比缩小到高为200px
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/x200
+```
+
+
+
+限定长边，生成不超过 200x200 的缩略图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x200
+```
+
+
+
+限定短边，生成不小于 200x200 的缩略图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!200x200r
+```
+
+
+
+强制生成 200x200 的缩略图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x200!
+```
+
+
+
+原图大于指定长宽矩形，按长边自动缩小为 200x200 缩略图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x200>
+```
+
+
+
+原图小于指定长宽矩形，按长边自动拉伸为 700x600 放大图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/700x600<
+```
+
+
+
+生成图的像素总数小于指定值
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/350000@
+```
+
+
+
+#### 裁剪
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/crop
+```
+
+裁剪操作参数表 (cropsize)
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/crop/x` | |指定目标图片宽度，高度不变。取值范围为0-10000。|
+| `/crop/x` | |指定目标图片高度，宽度不变。取值范围为0-10000。|
+| `/crop/x` | |同时指定目标图片宽高。取值范围为0-10000。 |
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息。|
+
+裁剪偏移参数表 (cropoffset)
+
+|参数名称 |必填 |说明 |
+|:- |:- |:- |
+| `/crop/!{cropsize}aa`| |相对于偏移锚点，向右偏移dx个像素，同时向下偏移dy个像素。取值范围不限，小于原图宽高即可。 |
+| `/crop/!{cropsize}-a`| |相对于偏移锚点，从指定宽度中减去dx个像素，同时向下偏移dy个像素。取值范围不限，小于原图宽高即可。 |
+| `/crop/!{cropsize}a-`| |相对于偏移锚点，向右偏移dx个像素，同时从指定高度中减去dy个像素。取值范围不限，小于原图宽高即可。 |
+| `/crop/!{cropsize}--`| |相对于偏移锚点，从指定宽度中减去dx个像素，同时从指定高度中减去dy个像素。取值范围不限，小于原图宽高即可。 |
+
+示例
+
+- /crop/!300x400a10a10 表示从源图坐标为 x:10,y:10 处截取 300x400 的子图片。
+- /crop/!300x400-10a10 表示从源图坐标为 x:0,y:10 处截取 290x400 的子图片。
+
+注意
+
+- 必须同时指定横轴偏移和纵轴偏移。
+- thumbnail 和 crop 之间的操作可以管道处理，即可以先对图进行缩略再裁剪，或者先裁剪再缩略。
+- gravity 会使其后的裁剪偏移 cropoffset 受到影响，建议放在 /crop 参数之前。
+- 计算偏移值会受到位置偏移指示符 /gravity/ 的影响。默认为相对于左上角 NorthWest 计算偏移值，参考 重心参数表。
+
+重心参数表
+
+在图片高级处理现有的功能中只影响其后的裁剪操作参数表，即裁剪操作以 gravity 为原点开始偏移后，进行裁剪操作。
+
+```
+NorthWest | North | NorthEast
+ | |
+ | |
+--------------+----------------+--------------
+ | |
+West | Center | East
+ | |
+--------------+----------------+--------------
+ | |
+ | |
+SouthWest | South | SouthEast
+```
+
+转义说明
+
+部分参数以 ! 开头，表示参数将被转义。为便于阅读，我们采用特殊转义方法，如下所示：
+
+```
+p => % (percent)
+r => ^ (reverse)
+a => + (add)
+```
+
+即!50x50r 实际代表 50x50^ 这样一个字符串。而!50x50实际代表 50x50 这样一个字符串（该字符串并不需要转义）。 中的 OffsetGeometry 部分可以省略，默认为 +0+0。即 /crop/50x50 等价于 /crop/!50x50a0a0，执行 -crop 50x50+0+0 语义。
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+限定宽最大300，生成裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/300x
+```
+
+
+
+限定高最大300，生成裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x
+```
+
+
+
+等比缩小到高为200px
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/x200
+```
+
+
+
+生成固定 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/300x300
+```
+
+
+
+生成 300x300 裁剪图，偏移距离 30x100
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300a30a100
+```
+
+
+
+生成 300x200 裁剪图，偏移距离 30x0
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300a30-100
+```
+
+
+
+生成 270x300 裁剪图，偏移距离 0x100
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300-30a100
+```
+
+
+
+生成 270x200 裁剪图，偏移距离 0x0
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300-30-100
+```
+
+
+
+锚点在左上角 (NorthWest)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/NorthWest/crop/300x300
+```
+
+
+
+锚点在正上方 (North)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/North/crop/300x300
+```
+
+
+
+锚点在右上角 (NorthEast)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/NorthEast/crop/300x300
+```
+
+
+
+锚点在正左方 (West)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/West/crop/300x300
+```
+
+
+
+锚点在正中 (Center)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/Center/crop/300x300
+```
+
+
+
+锚点在正右方 (East)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/East/crop/300x300
+```
+
+
+
+锚点在左下角 (SouthWest)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/SouthWest/crop/300x300
+```
+
+
+
+锚点在正下方 (South)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/South/crop/300x300
+```
+
+
+
+锚点在右下角 (SouthEast)，生成 300x300 裁剪图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/SouthEast/crop/300x300
+```
+
+
+
+#### 格式转换
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/format/
+ /colors/
+ /ignore-error/
+```
+
+参数说明
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+|`/format/` | |新图的输出格式
1、取值：jpg，gif，png，webp等，参考 支持转换的图片格式。
2、取值：heic 或 avif ，属于 图片高级压缩 格式，按照图片高级压缩收费，当前仅支持 持久化处理 来使用。
3、取值：缺省，默认保持原图格式输出。
注意：
● 必须指定mode参数，否则不生效。
● 当原图为heic 或 avif 时，如果 format 值缺省，会输出jpeg 。 |
+| `/colors/` | |1、源图片为 GIF 时，控制输出 GIF 中不同颜色的数量，取值可为2、4、8、16、32、64、128或256，不使用该参数时的默认值为128。
2、输出图片为 PNG 时，控制输出 PNG 中不同颜色的数量，取值可为2、4、8、16、32、64、128或256，不使用该参数时默认关闭。 |
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息。 |
+
+注意
+
+- 当一张含有透明区域的图片，转换成不支持透明区域的图片格式 jpg、bmp 等时，透明区域填充白色。
+
+**使用示例**
+
+转为png格式
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/png
+```
+
+#### 渐进显示
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/interlace/
+ /ignore-error/
+```
+
+参数说明
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/interlace/` | |是否支持渐进显示
取值范围：1 支持渐进显示，0不支持渐进显示(默认为0)。
适用目标格式：jpg
效果：网速慢时，图片显示由模糊到清晰。 |
+|`/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息。|
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+原图转为png后，并渐进显示图片：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/png/interlace/1
+```
+
+
+
+原图缩放后，并渐进显示图片：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/300x300/interlace/1
+```
+
+
+
+#### 背景色填充
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/background/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/background/` | |填充背景颜色，可以是颜色名称（比如red）或十六进制颜色（比如#FF0000）的URL安全的Base64编码。我们支持的颜色名称有transparent（#00000000）、none（#00000000）、white（#FFFFFF）、black（#000000）、red（#FF0000）、orange（#FFA500）、yellow（#FFFF00）、green（#008000）、blue（#0000FF）、purple（#800080）、gray（#7E7E7E）、pink（#FFC0CB），其中none与transparent均为透明背景色，另外十六进制颜色不区分大小写，具体颜色请参考颜色编码表。缺省背景色为white（#FFFFFF）。|
+| `/extent/` | |背景颜色填充的大小和偏移，即 {size}{offset}。
注意：dx、dy 取值范围不限，小于原图宽高即可。示例如下： |
1、/extent/!642x492a10a10 ，表示相对原图左上角，向右偏移10，向下偏移10，填充 642x492 大小的背景颜色。 |
2、/extent/!642x492-10-10 ，表示相对原图左上角，向左偏移10，向上偏移10，填充 642x492大小的背景颜色。 |
注意：dx、dy 取值范围不限，小于原图宽高即可。示例如下： |
1、/extent/!642x492a10a10 ，表示相对原图左上角，向右偏移10，向下偏移10，填充 642x492 大小的背景颜色。 |
2、/extent/!642x492-10-10 ，表示相对原图左上角，向左偏移10，向上偏移10，填充 642x492大小的背景颜色。 |
具体参数如下： |
+|`/extent/x` | |相对于原图中心位置，填充指定大小的背景颜色。 |
+|`/extent/xaa` | |相对于原图左上角，向右偏移dx个像素，同时向下偏移dy个像素，填充指定大小的背景颜色。 |
+|`/extent/!x--` | |相对于原图左上角，向左偏移dx个像素，同时向上偏移dy个像素，填充指定大小的背景颜色。 |
+|`/extent/!x-a` | |相对于原图左上角，向左偏移dx个像素，同时向下偏移dy个像素，填充指定大小的背景颜色。 |
+|`/extent/!xa-` | |相对于原图左上角，向右偏移dx个像素，同时向上偏移dy个像素，填充指定大小的背景颜色。 |
+|`/extent/!-a` | |相对于原图左上角，向左偏移dx个像素，同时向下偏移dy个像素，填充指定大小的背景颜色。 |
+|`/extent/!a-` | |相对于原图左上角，向右偏移dx个像素，同时向上偏移dy个像素，填充指定大小的背景颜色。 |
+|`/bordercolor/` | |填充背景颜色，可以是颜色名称（比如red）或十六进制颜色（比如#FF0000）的URL安全的Base64编码。我们支持的颜色名称有transparent（#00000000）、none（#00000000）、white（#FFFFFF）、black（#000000）、red（#FF0000）、orange（#FFA500）、yellow（#FFFF00）、green（#008000）、blue（#0000FF）、purple（#800080）、gray（#7E7E7E）、pink（#FFC0CB），其中none与transparent均为透明背景色，另外十六进制颜色不区分大小写，具体颜色请参考颜色编码表。缺省背景色为white（#FFFFFF）。|
+|`/border/x` | |相对于原图中心位置，填充指定大小的背景颜色。输出图像宽高为(OriWidth+2width) x（OriHeight + 2 height）
使用示例：http://rnjirg2hf.sabkt.gdipper.com/gogopher111.jpeg?imageMogr2/border/10x10/bordercolor/cmVk |
+|`/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息。 |
+
+**转义说明**
+
+部分参数以 ! 开头，表示参数将被转义。为便于阅读，我们采用特殊转义方法，如下所示：
+
+```
+p => % (percent)
+r => ^ (reverse)
+a => + (add)
+```
+
+即 `!50x50r` 实际代表 50x50 这样一个字符串。而 `!50x50`实际代表 50x50 这样一个字符串（该字符串并不需要转义）。 `` 中的 OffsetGeometry 部分可以省略，默认为 +0+0。即 /extent/50x50 等价于 /extent/!50x50a0a0。
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+旋转并添加背景色：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/auto-orient/thumbnail/!256x256r/gravity/center/crop/!256x256/blur/3x9/quality/80/rotate/45/background/b3Jhbmdl
+```
+
+
+
+添加1像素的红色边框：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/extent/!642x429/background/cmVk
+```
+
+
+
+左边填充3像素的红色边框：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/extent/!-3a0/background/cmVk
+```
+
+
+
+自适应填充背景色：
+
+```
+http://rnjirg2hf.sabkt.gdipper.com/gogopher111.jpeg?imageMogr2/border/10x10/bordercolor/cmVk
+```
+
+
+
+图片右边填充3像素的红色边框：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/extent/!a3-0/background/cmVk
+```
+
+
+
+图片上方填充3像素的红色边框：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/extent/!a0-3/background/cmVk
+```
+
+
+
+图片下方填充3像素的红色边框：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/extent/!-0a3/background/cmVk
+```
+
+
+
+#### 旋转
+
+**限制说明**
+
+- 原图格式支持：psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
+ - webp动图，仅支持持久化处理
+- 输出限制
+ - 输出为 gif，一般处理时间比较长，建议优先使用持久化处理
+ - 输出为 webp 时，宽或高不能超过16383
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/auto-orient
+ /rotate/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/auto-orient` | |自适应旋转：与图像处理顺序相关，建议放在首位，根据原图EXIF信息自动旋正，便于后续处理。|
+| `/rotate/` | |普通旋转：图片顺时针旋转角度，取值范围为1-360，默认为不旋转。|
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息 |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+顺时针旋转 45 度：
+
+```
+ https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/rotate/45
+```
+
+
+
+#### 高斯模糊
+
+**限制说明**
+
+- 原图格式支持：psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
+ - webp动图，仅支持持久化处理
+- 输出限制
+ - 输出为 gif，一般处理时间比较长，建议优先使用持久化处理
+ - 输出为 webp 时，宽或高不能超过16383
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/blur/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `/blur/` | |高斯模糊参数。radius是模糊半径，取值范围为1-50。sigma是正态分布的标准差，必须大于0。图片格式为gif时，不支持该参数。|
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息 |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+半径为 3，Sigma 值为 5：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/blur/3x5
+```
+
+
+
+#### 锐化
+
+**限制说明**
+
+- 原图格式支持：psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
+ - webp动图，仅支持持久化处理
+- 输出限制
+ - 输出为 gif，一般处理时间比较长，建议优先使用持久化处理
+ - 输出为 webp 时，宽或高不能超过16383
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/sharpen/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+|`/sharpen/` | |图片是否锐化，当设置值为1时打开锐化效果。|
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息 |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+设置锐化参数为1，进行锐化处理
+
+```
+https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/sharpen/1
+```
+
+
+
+#### 图像DPI
+
+**限制说明**
+
+- 原图格式支持：psd、jpeg、png、gif、webp、tiff、bmp
+ - webp动图，仅支持持久化处理
+- 输出限制
+ - 输出为 gif，一般处理时间比较长，建议优先使用持久化处理
+ - 输出为 webp 时，宽或高不能超过16383
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+
+**接口规格**
+
+注意：接口规格不含任何空格与换行符。
+
+```
+imageMogr2/density/
+ /ignore-error/
+```
+
+**参数说明**
+
+|参数名称 |必填 |说明 |
+|:-|:-|:- |
+| `density/` | |图像DPI值的修改值范围：1-1200，默认为原图DPI值。|
+| `/ignore-error/` | |主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
不设置此参数，默认处理失败时返回错误信息 |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+设置输出分辨率为300DPI，进行处理。
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/density/300
+```
+
+
+
+### 图片基本信息
+
+**简介**
+
+图片基本信息包括图片格式、图片大小、色彩模型。
+
+**限制说明**
+
+- 原图支持20MB以内的图片
+
+**接口规格**
+
+```
+imageInfo
+```
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+获取图片基本信息
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?imageInfo
+```
+
+返回结果（内容经过格式化以便阅读）：
+
+```js
+{
+ size: 214513,
+ format: "jpeg",
+ width: 640,
+ height: 427,
+ colorModel: "ycbcr",
+ orientation: "Top-left"
+}
+```
+
+|字段名称 |必填 |说明 |
+|:- |:- |:- |
+|size |是 |文件大小，单位：Bytes |
+|format |是 |图片类型，如png、jpeg、gif、bmp等。|
+|width |是 |图片宽度，单位：像素(px)。 |
+|height |是 |图片高度，单位：像素(px)。 |
+|colorModel |是 |色彩模型，如palette16、ycbcr等。 |
+|frameNumber| |帧数，gif 图片会返回此项 |
+
+### 图片 EXIF 信息
+
+**简介**
+
+EXIF(EXchangeable Image File Format) 是专门为数码相机的照片设定的可交换图像文件格式。
+
+**限制说明**
+
+- 缩略图等经过云处理的新图片不支持EXIF
+- 原图格式为avif、heif不支持EXIF
+- 原图只支持 20MB 以内的图片
+
+
+**接口规格**
+
+```
+exif
+```
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+获取图片 EXIF 信息
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?exif
+```
+
+返回结果（内容经过格式化以便阅读）：
+
+```js
+{
+ "DateTime" : {
+ "type" : 2,
+ "val" : "2011:11:19 17:09:23"
+ },
+ "ExposureBiasValue" : {
+ "type" : 10,
+ "val" : "0.33 EV"
+ },
+ "ExposureTime" : {
+ "type" : 5,
+ "val" : "1/50 sec."
+ },
+ "Model" : {
+ "type" : 2,
+ "val" : "Canon EOS 600D"
+ },
+ "ISOSpeedRatings" : {
+ "type" : 3,
+ "val" : "3200"
+ },
+ "ResolutionUnit" : {
+ "type" : 3,
+ "val" : " 英寸"
+ },
+ ...后续内容已省略...
+}
+```
+
+### 图片圆角
+
+**简介**
+
+将图片生成圆角图片，并且可以指定图片的圆角大小。
+
+**限制说明**
+
+- 原图格式支持：png、jpg，处理后的图片格式为png
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+**接口规格**
+
+处理后图片文件大小没有限制
+
+```
+roundPic/radius/
+ /radiusx/
+ /radiusy/
+```
+
+|参数名称 |必填 |说明 |
+|:- |:- |:- |
+|`/radius/` |否 |圆角大小的参数，水平和垂直的值相同，可以使用像素数（如200）或百分比（如!25p）。不能与radiusx和radiusy同时使用。|
+|`/radiusx/` |否 |圆角水平大小的参数，可以使用像素数（如200）或百分比（如!25p）。需要与radiusy同时使用。 |
+|`/radiusy/` |否 |圆角垂直大小的参数，可以使用像素数（如200）或百分比（如!25p）。需要与radiusx同时使用 |
+
+注意：
+
+1. 其中当像素数大于宽（高）的1/2时取其1/2，百分比大于!50p时，取!50p；
+2. 像素数与百分比均需为非负值，命令roundPic/radius/!50p可使方形图片变圆
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+把一张图片变成50度圆角：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?roundPic/radius/50
+```
+
+
+
+把一张图片变成圆形：
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?roundPic/radius/99999999999
+```
+
+
+
+### 图片水印处理
+
+**简介**
+
+给图片添加水印
+
+**限制说明**
+
+- 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
+ - webp动图，适用于watermark/1、watermark/2、watermark/3 接口，仅支持持久化处理
+- 输出限制
+ - 输出为gif，一般处理时间比较长，建议优先使用 持久化处理
+- 同步处理
+ - 原图只支持 20MB 以内的图片，超过 20MB 的图片请使用持久化处理
+ - 理前的 `gif` 最大帧数为 200
+ - 处理前的图片 `w` 和 `h` 参数不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
+- 持久化处理
+ - 图片文件大小没有限制
+ - 处理前的 `gif`、`webp动图`，最大帧数为 500
+ - 处理前的图片 `w` 和 `h` 不能超过3万像素，总像素不能超过1.5亿像素
+ - 处理后的图片 `w` 和 `h` 不能超过14999像素，总像素不得超过59999999（6000w-1）像素
+
+**接口规格**
+
+处理后图片文件大小没有限制
+
+```
+watermark/1
+ /format/
+ /image/
+ /dissolve/
+ /gravity/
+ /dx/
+ /dy/
+ /ws/
+ /wst/
+```
+
+|参数名称 |必填 |说明 |
+|:- |:- |:- |
+| `/format/` | |图片输出格式
1、取值：heic 或 avif ，属于 图片高级压缩 格式，按照图片高级压缩收费，当前仅支持 持久化处理 来使用。
2、取值：copy，保持原图格式输出。
注意：
● 当原图为heic 或 avif 时，设置format/copy 会保持原图格式不变，且不按照图片高级压缩收费；如果不指定 format 参数，将会输出jpeg 。 |
+| `/image/` |是 |水印的源路径，目前支持 kodo 资源。kodo 资源可由 `kodo:///` 表示（此时 bucketname 需要与输入源在同一区域），均需要经过[URL安全的Base64编码](#urlsafeBase64Encode)。
注意：更换图片水印时，建议更换图片的文件名。 |
+| `/dissolve/` | |透明度，取值范围1-100，默认值为100（完全不透明）。 |
+| `/gravity/` | |水印位置，参考水印锚点参数表，默认值为SouthEast（右下角）。 |
+| `/dx/` | |横轴边距，单位:像素(px)，默认值为10。 |
+| `/dy/` | |纵轴边距，单位:像素(px)，默认值为10。 |
+| `/ws/` | |水印图片自适应原图的比例，ws的取值范围为0-1。具体是指水印图片保持原比例，按照自适应原图的类型wst，比如默认是按照短边，则水印图片短边=原图短边＊ws。 |
+| `/wst/` | |水印图片自适应原图的类型，取值0、1、2、3分别表示为自适应原图的短边、长边、宽、高，默认值为0。 |
+
+例如：
+
+1. 原图大小为250x250，水印图片大小为91x61，如果wst=0、ws=0.1，那么最终水印图片的大小为：37.2x25
+2. 原图大小为250x250，水印图片大小为91x61，如果wst=1、ws=0.1，那么最终水印图片的大小为：25x16.8
+
+水印锚点参数表
+
+```
+NorthWest | North | NorthEast
+ | |
+ | |
+--------------+----------------+--------------
+ | |
+West | Center | East
+ | |
+--------------+----------------+--------------
+ | |
+ | |
+SouthWest | South | SouthEast
+```
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+- 水印图片
+ - kodocheme = kodo://developer-documents-image/qiniuyun.png
+ - encodedkodocheme = a29kbzovL2RldmVsb3Blci1kb2N1bWVudHMtaW1hZ2UvcWluaXV5dW4ucG5n
+- 水印透明度: 50% (dissolve=50)
+- 水印位置: 右下角 (gravity=SouthEast)
+- 横向边距: 20px
+- 纵向边距: 20px
+- 水印图片自适应短边比例：0.2
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?watermark/1/image/a29kbzovL2RldmVsb3Blci1kb2N1bWVudHMtaW1hZ2UvcWluaXV5dW4ucG5n/dissolve/50/gravity/SouthEast/dx/20/dy/20/ws/0.2
+```
+
+
+
+### 图片盲水印处理
+
+**简介**
+
+肉眼可见的水印方式，一般用于标志图片的出处或者用于声明版权，会破坏原图，且影响美观。扩展存储提供盲水印功能，隐蔽性强，在不破坏原始作品的情况下，实现版权的防护与追踪。当图片被盗用后，您可对图片进行盲水印解码，验证版权归属。
+
+**限制说明**
+
+- 原图限制：
+ - 原图格式支持： jpg、png
+ - 宽高限制为：4096x4096
+ - version为3时，原图的尺寸宽高都需大于512
+- 编码、解码的 version 要相同
+- 盲水印主要为CPU密集型任务，处理时间会随着图片文件的增大而增大
+- 建议使用 version/3，相较于之前的版本有以下优化：
+ - 解水印不需要对比原图，去除对原图的依赖
+ - 抗大面积涂抹&裁剪攻击
+
+**应用场景**
+
+- 隐形美观：盲水印是一种肉眼不可见的水印方式，可以保持图片美观的同时，保护您的资源版权。
+- 版权保护：对图片资源使用图片盲水印或者文字水印，借此避免数字媒体未经授权的复制和拷贝，可通过对原图进行解码操作，得到水印图来证明版权归属。
+- 防泄漏：对于内部分享的图片资源，您可使用盲水印功能，加上不同标识，如果资料被复制、传播可根据解码出的唯一标识得出泄露方信息。
+
+#### 图片盲水印
+
+**接口规格**
+
+```
+watermark/5
+ /version/
+ /method/
+ /imageKey/
+ /orignal/
+```
+
+**添加水印**
+
+version 为1或2时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+| `/version/` |N |接口版本值为1或2 , 默认为 1。 |
+| `/method/` |Y |盲水印标志位，编码（添加水印）为encode。 |
+| `/imageKey/` |N |水印图片（经过[URL安全的Base64编码](#urlsafeBase64Encode)）
例如：imageKey=upload.png，encodedImageKey=urlsafe_base64_encode(imageKey)。
注意：水印图片宽高分别不超过原图宽高的二分之一，图片为黑底白字效果更佳。 |
+
+version 为3时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:-|:-|:- |
+| `/version/` |N |接口版本值为3，注意：
1）原图的宽高都需大于512。
2）水印图片的限制，必须是二值图像，且水印的大小为64x64，如果不符合条件， 会缩放和处理图片到服务要求。 |
+|`/method/` |Y |盲水印标志位，编码（即添加水印）为encode。 |
+|`/imageKey/` |N |水印图片（经过[URL安全的Base64编码](#urlsafeBase64Encode)）
例如：imageKey=upload.png，encodedImageKey=urlsafe_base64_encode(imageKey) |
+
+**提取水印**
+
+version 为1或2时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+| `/version/` |N |接口版本值为1或2 , 默认为 1。 |
+| `/method/` |Y |盲水印标志位，解码（即提取水印）为decode。 |
+| `/orignal/`|N |解码对比原图（经过[URL安全的Base64编码](#urlsafeBase64Encode)）|
+
+version 为3时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+|`/version/` |N |接口版本值为3，注意：原图的宽高都需大于512。 |
+|`/method/` |Y |盲水印标志位，解码（即提取水印）为decode |
+
+**使用示例**
+
+原图
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg
+```
+
+
+
+编码/ 添加盲水印（version/3)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/5/version/3/method/encode/imageKey/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvdW5pQ2xvdWQucG5n
+```
+
+
+
+解码/ 提取盲水印（version/3)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/5/version/3/method/encode/imageKey/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvdW5pQ2xvdWQucG5n|watermark/5/version/3/method/decode
+```
+
+
+
+编码/ 添加盲水印（version/2)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/5/version/2/method/encode/imageKey/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvdS5wbmc=
+```
+
+
+
+解码/ 提取盲水印（version/2)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/5/version/2/method/encode/imageKey/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvdS5wbmc=|watermark/5/version/2/method/decode/orignal/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvZ29nb3BoZXIxLnBuZw==
+```
+
+
+
+#### 文字盲水印
+
+**接口规格**
+
+```
+watermark/6
+ /version/
+ /method/
+ /text/
+ /orignal/
+```
+
+**添加水印**
+
+version 为1或2时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+| `/version/` |N |接口版本值为1或2 , 默认为 1。 |
+| `/method/` |Y |盲水印标志位，编码（添加水印）为encode。 |
+| `/text/` |N |水印文字（经过[URL安全的Base64编码](#urlsafeBase64Encode)）。只支持英文数字字符，不支持中文字符，数量上限分别为 10。 |
+
+version 为3时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:-|:-|:- |
+| `/version/` |N |接口版本值为3，注意：
1）原图的宽高都需大于512。
2）水印图片的限制，必须是二值图像，且水印的大小为64x64，如果不符合条件， 会缩放和处理图片到服务要求。 |
+|`/method/` |Y |盲水印标志位，编码（即添加水印）为encode。 |
+|`/text/` |N |水印文字（经过URL安全的Base64编码）。只支持英文数字字符，不支持中文字符，数量上限分别为 15。 |
+
+**提取水印**
+
+version 为1或2时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+| `/version/` |N |接口版本值为1或2 , 默认为 1。 |
+| `/method/` |Y |盲水印标志位，解码（即提取水印）为decode。 |
+| `/orignal/`|N |解码对比原图（经过URL安全的Base64编码）|
+
+version 为3时，请求参数说明如下：
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+|`/version/` |N |接口版本值为3，注意：原图的宽高都需大于512。 |
+|`/method/` |Y |盲水印标志位，解码（即提取水印）为decode |
+
+**使用示例**
+
+原图
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png
+```
+
+
+
+编码/ 添加盲水印（version/3)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/6/version/3/method/encode/text/MTIzNDU2Nzg5
+```
+
+
+
+解码/ 提取盲水印（version/3)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/6/version/3/method/encode/text/MTIzNDU2Nzg5|watermark/6/version/3/method/decode
+```
+
+
+
+编码/ 添加盲水印（version/2)
+
+```
+https://dora-doc.qiniu.com/gogopher.jpg?watermark/6/version/2/method/encode/text/OTAyR0h3cmM=
+```
+
+
+
+解码/ 提取盲水印（version/2)
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/gogopher1.png?watermark/6/version/2/method/encode/text/OTAyR0h3cmM=|watermark/6/version/2/method/decode/orignal/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvZ29nb3BoZXIxLnBuZw==
+```
+
+
+
+### 动图合成
+
+**简介**
+
+动图合成接口（animate）用于将多张图片合成 GIF 动图。
+
+**限制说明**
+
+- 原图限制：
+ - 支持的格式有 jpeg 和 png
+ - 支持的最大帧数为 20
+ - 支持的最大图片尺寸为 1080*1080
+
+**接口规格**
+
+```
+animate/duration/
+ /merge/key/
+ /key/
+ ...
+ /effect/
+```
+
+**参数说明**
+
+|名称 |必填 |说明 |
+|:- |:- |:- |
+| `` |Y |GIF动图的每帧间隔时间(单位: 0.01s)，取值要求为大于0的整数。 |
+| `` |N |合成GIF动图的源图片key需要经过 [URL安全的Base64编码](#urlsafeBase64Encode) ，且保证所有的源图都来源于同一个bucket。 |
+| `` |N |定义播放顺序，取值：0，1。（0:正序循环播放；1:倒序循环播放；）默认为0 |
+
+第一张图
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/1.png
+```
+
+
+
+第二张图
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/2.png
+```
+
+
+
+第三张图
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/3.png
+```
+
+
+
+三张图合成一张动图
+
+```
+https://web-ext-storage.dcloud.net.cn/unicloud/ext-storage/1.png?animate/duration/10/merge/key/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvMi5wbmc=/key/dW5pY2xvdWQvZXh0LXN0b3JhZ2UvMy5wbmc=
+```
+
+### URL安全的Base64编码@urlsafeBase64Encode
+
+图片处理部分API会涉及到 `经过URL安全的Base64编码`，具体算法如下
+
+**云端代码示例**
+
+```js
+function urlsafeBase64Encode(text) {
+ let encoded = Buffer.from(text).toString('base64');
+ return encoded.replace(/\//g, '_').replace(/\+/g, '-');
+};
+let base64 = urlsafeBase64Encode("test/a.jpg");
+console.log('base64: ', base64);
+```
+
+**前端代码示例（仅H5端可用）**
+
+```js
+function urlsafeBase64Encode(text) {
+ // 使用window.btoa进行Base64编码，得到的是URL安全的Base64字符串
+ let encoded = window.btoa(text);
+ // 由于window.btoa已经使用_和-代替了+和/，所以不需要额外替换
+ return encoded;
+};
+let base64 = urlsafeBase64Encode("test/a.jpg");
+console.log('base64: ', base64);
+```
+
+## 音视频转码@transcode
+
+扩展存储支持上传的音视频自动进行转码（无需调用API），[查看音视频转码费用](./price.md#transcode)
+
+开启音视频转码功能需要进 [扩展存储技术交流群](https://im.dcloud.net.cn/#/?joinGroup=65436862cc41b0763842cfc9) 申请发送文字：我想申请开通扩展存储音视频转码功能，我的转码类型是“普通转码（H.264）”
+
## 常见问题@question
### 运行报错，当前空间不支持provider:"qiniu"@q1
diff --git a/docs/ext-storage/price.md b/docs/ext-storage/price.md
index b670146435f3d50a1e6002f9b9208f0dfc2d411f..24f71a3d2527ccae4d9b4dc88f6306e7a5d608d4 100644
--- a/docs/ext-storage/price.md
+++ b/docs/ext-storage/price.md
@@ -2,7 +2,7 @@
uniCloud扩展存储费用由存储费用和CDN费用两部分组成，其中CDN费用相比业内价格，有巨大优势。
-### CDN费用
+### CDN费用@cdn
uniCloud扩展存储CDN费用，按从CDN节点流出的下行流量（单位GB）阶梯计费，当月按账户维度进行阶梯累进（以自然月为一个累计周期）。
@@ -44,7 +44,7 @@ uniCloud扩展存储CDN费用，按从CDN节点流出的下行流量（单位GB
* 另外，云厂商的资源包都是有有效期的（通常为1个月、6个月、1年），过期未用完，资源包会自动作废；而uniCloud扩展存储按照自然月阶梯计费，不存在有效期的概念；
* 阿里云、腾讯云的价格，采集日期为2024.01.29
-### 存储费用
+### 存储费用@storage
|资源项 |单位 |售价（元） | 说明|
@@ -66,9 +66,12 @@ uniCloud扩展存储CDN费用，按从CDN节点流出的下行流量（单位GB
- 请求次数维度：uniCloud扩展存储比阿里云便宜20%，比腾讯云便宜98%！
- 虽然阿里云没有回源流量，但一般业务场景下，回源流量之于CDN流量，占比通常在5%以内，而uniCloud扩展存储的CDN流量相比阿里云是有大幅优势的，至少便宜33%，故从总账来看，uniCloud扩展存储的总体性价比是极佳的。
-### 图片处理费用
+### 图片处理费用@imageshandle
-注意：只有用到了图片处理API时才会计费
+注意：
+
+1. 只有用到了图片处理API时才会计费
+2. 命中 CDN 缓存情况下不计量
|资源项 |售价（元） |
|-- |-- |
@@ -82,9 +85,9 @@ uniCloud扩展存储CDN费用，按从CDN节点流出的下行流量（单位GB
|图片水印处理 |0.025 元/GB |
|图片圆角 |0.025 元/GB |
-### 音视频转码费用
+### 音视频转码费用@transcode
-注意：只有用到了音视频转码时才会计费，开启音视频转码功能需要进 [扩展存储技术交流群](https://im.dcloud.net.cn/#/?joinGroup=65436862cc41b0763842cfc9) 申请，发送文字：我想申请开通扩展存储音视频转码功能，我的转码类型是“普通转码（H.264）”
+注意：只有用到了音视频转码时才会计费，开启音视频转码功能需要进 [扩展存储技术交流群](https://im.dcloud.net.cn/#/?joinGroup=65436862cc41b0763842cfc9) 申请发送文字：我想申请开通扩展存储音视频转码功能，我的转码类型是“普通转码（H.264）”
不同编码方式，音视频转码（包含普通转码、锐智转码、倍速转码、音视频拼接等）定价如下：