简介

七牛云存储提供四种水印接口：图片水印、文字水印，文字平铺水印、混合水印、渐变色水印。

使用限制

• 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp（webp不支持动图）
• 输出限制
  • 输出为gif，一般处理时间比较长，建议优先使用持久化处理
• 同步处理
  • 只支持 20MB 以内的图片，超过 20MB 的图片需要使用持久化处理
  • 处理前的gif最大帧数为 200
  • 处理前的图片w和h参数不能超过3万像素，总像素不能超过1.5亿像素
  • 处理后的图片w和h参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
  • 处理后图片文件大小没有限制
• 持久化处理
  • 图片文件无大小限制
  • 处理前的gif最大帧数为 500
  • 处理前的图片w和h参数不能超过3万像素，总像素不能超过1.5亿像素
  • 处理后的图片w和h参数不能超过14999像素，总像素不得超过59999999（6000w-1）像素
  • 处理后图片文件大小没有限制
    ​

图片水印

接口规格

注意： 接口规格不含任何空格与换行符。

watermark/1
         /image/<encodedImageURL>
         /dissolve/<dissolve>
         /gravity/<gravity>
         /dx/<distanceX>
         /dy/<distanceY>
         /ws/<watermarkScale>
         /wst/<watermarkScaleType>

例如：原图大小为250x250，水印图片大小为91x61，如果ws=1，那么最终水印图片的大小为：372x250。

水印锚点参数表

NorthWest     |     North      |     NorthEast
              |                |    
              |                |    
--------------+----------------+--------------
              |                |    
West          |     Center     |          East 
              |                |    
--------------+----------------+--------------
              |                |    
              |                |    
SouthWest     |     South      |     SouthEast

使用示例

• 水印图片：

  • ImageURL = "https://dora-doc.qiniu.com/qiniuyun.png"
  • encodedImageURL = aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20vcWluaXV5dW4ucG5n

• 水印透明度: 50% (dissolve=50)

• 水印位置: 右下角 (gravity=SouthEast)

• 横向边距: 20px

• 纵向边距: 20px

• 水印图片自适应短边比例：0.2

  https://dora-doc.qiniu.com/gogopher.jpg?watermark/1/image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20vcWluaXV5dW4ucG5n/dissolve/50/gravity/SouthEast/dx/20/dy/20/ws/0.2
  

文字水印

接口规格

注意： 接口规格不含任何空格与换行符。

watermark/2
         /text/<encodedText>
         /font/<encodedFontName>
         /fontsize/<fontSize>
         /fill/<encodedTextColor>
         /dissolve/<dissolve>
         /gravity/<gravity>
         /dx/<distanceX>
         /dy/<distanceY>

使用示例

• 水印文本：七牛云

• 水印文本字体：宋体

• 水印文本字体大小：400

• 水印文本颜色：gray

  https://dora-doc.qiniu.com/gogopher.jpg?watermark/2/text/5LiD54mb5LqR5a2Y5YKo/font/5a6L5L2T/fontsize/400
  

文字平铺水印

接口规格

watermark/4
         /text/<encodedText>
         /font/<encodedFontName>
         /fontsize/<fontSize>
         /fill/<encodedTextColor>
         /dissolve/<dissolve>
         /rotate/<rotate>
         /uw/<unitW>
         /uh/<unitH>
         /resize/<resize>

使用示例

• 水印文本：七牛云存储

• 水印文本字体：宋体

• 水印文本字体大小：400

• 水印文本颜色：gray

• 水印文本透明度：50% (dissolve=50)

• 水印文字旋转角度: 30

• 水印文字填充单元宽度：180

• 水印文字填充单元高度：180

• 水印文字填充单元缩放比例： 1

  https://dora-doc.qiniu.com/gogopher.jpg?watermark/4/text/5LiD54mb5LqR5a2Y5YKo/font/5a6L5L2T/fontsize/400/fill/Z3JheQ==/dissolve/50/rotate/30/uw/180/uh/180/resize/1
  

混合水印

本接口用于同时在一个原图上打多个不同类型的水印。

接口规格

watermark/3
         /text/<textWaterMarkParams1>
         /image/<imageWaterMarkParams1>
         /image/<imageWaterMarkParams2>
         /text/<textWaterMarkParams2>
         ...

注意：

• 省略号表示可以附加多个规格参数。
• 图片水印与文字水印的规格可以混写，按给定顺序处理。

使用示例

• 对原图加上多个混合水印，可以通过多个水印 Params 组合/image/imageWaterMarkParams，/text/textWaterMarkParams 来实现；示例共添加了6个不同图片和文字水印。

  https://dora-doc.qiniu.com/baidi.png?watermark/3
  	/image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20veGlhb2ppLnBuZw==/gravity/North/dy/-10/dx/0
  	/text/5ZCD6L-H54yr5bGx546L77yM5YW25LuW5qa06I6y55qG6Lev5Lq6/gravity/SouthWest/dx/10/dy/180/fontsize/500
  	/text/5LuF6ZmQN-WkqSAgMjAxOS4wNC4wMS0yMDE5LjA0LjA3/gravity/SouthWest/dx/30/dy/130/fontsize/300
  	/image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20vcXVhbi5wbmc=/gravity/SouthWest/dx/80/dy/30
  /image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20v5LqM57u056CBLnBuZw==/gravity/SouthEast/dx/10/dy/30
  	/text/5omr56CB6aKG5Y-W5LyY5oOg5Yi4/gravity/SouthEast/dx/50/dy/10/fontsize/300/fill/UmV
  

渐变色水印

接口规格

watermark/7
         /ori/<Orientation>
         /startpos/<StartPosition>
         /stoppos/<StopPosition>
         /startclr/<StartColor>
         /stopclr/<StopColor>

请求参数详解

使用示例

• 渐变色方向：1 (自上而下)

• 渐变开始位置：0

• 渐变结束位置：100

• 开始位置颜色及透明度：#FF0000FF（红色不透明）

• 结束位置颜色及透明度：#FF000000（红色透明）

  https://dora-doc.qiniu.com/gogopher.jpg?watermark/7/ori/1/startpos/0/stoppos/100/startclr/I0ZGMDAwMEZG/stopclr/I0ZGMDAwMDAw
  

操作方式

您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式，对图片进行处理，详情介绍请参见图片处理操作方式。