全部文档
当前文档

热搜词推荐

云服务器 虚拟私有网络 边缘节点计算 对等连接

共搜索到 0 条结果

暂无内容

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

文档中心

对象存储(KS3)

查看更多结果
未找到含当前关键字的文档标题
页面目录
全部展开全部收起
未找到含该关键词的产品
文档中心 对象存储(KS3) 用户指南 图片处理 图片处理操作 图片水印

图片水印

最近更新时间：2024-03-28 19:20:13

接口

imgWaterMark

描述

金山云提供三种水印功能，包括文字水印、图片水印，以及多重水印。如果你拥有对图片文件的读权限，那么你可以对该图片添加水印。通过添加水印，你可以制作个性的图片，或者标识图片来源以及版权信息。

说明

  1. 权限

该接口操作需要具备ks3:GetObject权限。

2. 图片水印

水印源图片URL目前仅支持HTTP协议，若使用HTTPS，会返回状态码400错误。 对于部分汉字水印，样式编码时可能会出现‘+’、‘/’等特殊字符，这时需要在URL对这些字符进行转译才能正常访问，具体转译见下表：

特殊字符

url中表示结果

转移码(%+ASCII码)

+

URL 中+号表示空格

%2B

空格

URL中的空格可以用+号或者编码

%20

/

分隔目录和子目录

%2F

?

分隔实际的URL和参数

%3F

*

指定特殊字符

%25

#

表示书签

%23

&

URL 中指定的参数间的分隔符

%26

=

URL 中指定参数的值

%3D

3.文字水印

文字水印支持的字体类型详见下表

字体参数值

字体中文名称

Base64编码值

AvantGarde-Book

AvantGarde-Book

QXZhbnRHYXJkZS1Cb29r

AvantGarde-BookOblique

AvantGarde-Book

QXZhbnRHYXJkZS1Cb29rT2JsaXF1ZQ==

AvantGarde-Demi

AvantGarde-Book

QXZhbnRHYXJkZS1EZW1p

AvantGarde-Demi

AvantGarde-Book

QXZhbnRHYXJkZS1EZW1p

请求（文字水印）

语法


https://BucketName.${bucket所在region的域名}/object@base@
    tag=imgWaterMark
    &type=2
    &text=<base64EncodeText>
    &font=<base64EncodeFont>
    &fontsize=<fontsize>
    &fill=<base64EncodeFill>
    &dissolve=<dissolve>
    &gravity=<gravity>
    &dx=<offsetX>
    &dy=<offsetY>

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

请求参数

参数名称

必填

解释说明

tag

是

操作标志，取值为接口名称。比如进行图片水印的操作，则URL中tag=imgWaterMark 。

type

是

type=2 文字水印

text

是

水印文字(base64EncodeText，经过URL安全的Base64编码)

font

否

文字水印字体(base64EncodeFont，经过URL安全的Base64编码)。默认为黑体

fontsize

否

字体大小(整形)，单位为缇(1缇=1/20磅)，默认值500

fill

否

文字水印颜色(base64EncodeFill，经过URL安全的Base64编码)，可以是RGB格式，也可以是颜色名称(例如 black)，还可以是十六进制(例如 ## FF0000)，可以参考RGB对照表

dissolve

不透明度。取值范围为1~100，默认值为100。100为完全不透明

gravity

水印位置。可参考下面的水印锚点参数表，默认为SouthEast(右下方)

dx

横轴(x轴)边距，单位为像素(px)，默认值为10

dy

纵轴(y轴)边距，单位为像素(px)，默认值为10

q

否

决定 jpg 图片的相对quality，对原图压缩。范围为0-100，0表示高压缩低质量，100表示低压缩，高质量。默认90

rotate

否

水印文字旋转角度，[-180, 180]， 默认为0

tile

否

指定是否将文字水印铺满原图， 1：表示将文字水印铺满原图， 0（默认值）：表示不将文字水印铺满全图

uw

否

水印文字填充单元宽度，默认值为1

uh

否

水印文字填充单元高度，默认值为1

水印锚点参数列表

NorthWest

North

NorthEast

West

Center

East

SouthWest

South

SouthEast

请求头部

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

请求（图片水印）

语法


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>   HTTP/1.1
Host: BucketName.ks3-cn-beijing.ksyuncs.com

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

请求参数

参数名称

必填

解释说明

tag

是

操作标志

type

是

type=1 为图片水印

image

是

水印源图片网址(base64EncodeImageURI，经过URL安全的Base64编码),必须保证此网址返回一张图片

dissolve

不透明度。取值范围为1~100，默认值为100。100为完全不透明

gravity

水印位置。可参考下面的水印锚点参数表，默认为SouthEast(右下方)

dx

横轴(x轴)边距，单位为像素(px)，默认值为10

dy

纵轴(y轴)边距，单位为像素(px)，默认值为10

q

否

决定 jpg 图片的相对quality，对原图压缩。范围为0-100，0表示高压缩低质量，100表示低压缩，高质量。默认90

wtw

否

水印添加宽度阈值，小于该值将不进行图片水印操作，单位为像素(px)。范围为0以上的整数

wth

否

水印添加高度阈值，小于该值将不进行图片水印操作，单位为像素(px)。范围为0以上的整数

水印锚点参数列表

NorthWest

North

NorthEast

West

Center

East

SouthWest

South

SouthEast

请求头部

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

响应：

响应头部

头部名称

必填

说明

Content-Type

是

MIME类型，成功时为图片固定的MIME类型image/*，失败时为application/json

响应内容

  • 如果请求处理成功，返回图片的二进制图片数据。

  • 如果请求失败，则返回如下JSON格式的内容：

    
{
    "errorCode": <HttpCode int>,
    "tipInfo": <ErrorTipInfo String>,
}

特殊错误

HTTP状态码

含义

400

请求报文格式错误

404

资源不存在

403

访问拒绝

500

服务端操作失败

示例

如下所示为一些关于水印功能的简单示例：

请求示例（文字水印）

  • 水印文字：金山云

    • 原始水印文字=金山云

    • 加密水印文字(base64)=6YeR5bGx5LqR

    • text=6YeR5bGx5LqR

  • 水印文字字体：微软雅黑

    • 原始文字字体=微软雅黑

    • 加密水印字体(base64)=5b6u6L2v6ZuF6buR

    • font=5b6u6L2v6ZuF6buR

  • 水印文字颜色：## bf1717(红色)

    • 原始字体颜色=## bf1717

    • 加密字体颜色(base64)=I2JmMTcxNw==

    • fill=I2JmMTcxNw==

  • 水印字体大小：500 (单位:缇)

    • fontsize=500

    • 水印位置:右上角

    • gravity=NorthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:10

    • dx=10

  • 纵轴边距:10

    • dy=10

请求代码


https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark
    &type=2
    &dissolve=65
    &gravity=NorthEast
    &text=6YeR5bGx5LqR
    &font=5b6u6L2v6ZuF6buR
    &fill=I2JmMTcxNw==
    &fontsize=500
    &dy=10
    &dx=20

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

响应示例

文字水印示例

请求示例（图片水印）

  • 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

    • 原始图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

    • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

    • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • 水印位置:右上角

    • gravity=NorthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:10

    • dx=10

  • 纵轴边距:10

    • dy=10

请求代码


https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy1yZXNvdXJjZXMua3MzLWNuLWJlaWppbmcua3N5dW5jcy5jb20vZml4ZWRfa3NjX2xvZ28ucG5n
    &dy=10   
    &dx=10

注意：

  • 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

  • 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例

图片水印示例

请求示例（多重水印）

多重水印，包括对同一张图片可以执行两种或多种操作(基本图片操作和图片水印)，两种操作直接用"|"间隔就OK了。

  • 宽度为200px，高度为150px

  • 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 水印位置:右下角

    • gravity=SouthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:10

    • dx=10

  • 纵轴边距:10

    • dy=10

请求代码


https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgScale   
    &mode=0   
    &h=160   
    &w=220   
    |tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10
    |tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=SouthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10

注意：

  • 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

  • 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例

多重水印示例

请求示例（图片水印阈值示例）

  • 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

    • 原始图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

    • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

    • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • 水印位置:右上角

    • gravity=NorthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:10

    • dx=10

  • 纵轴边距:10

    • dy=10

  • 宽度阈值:500

    • wtw=500

  • 高度阈值:500

    • wth=500

请求代码


https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10
    &wtw=500
    &wth=500

注意：

  • 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

  • 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

    响应示例

    图片水印示例

请求示例（同时设置文字水印和图片水印）

同时设置文字水印和图片水印，包括对同一张图片可以同时设置文字水印和图片水印。

  • 水印图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

    • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

    • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

    • 水印位置:右上角

      • gravity=NorthEast

    • 水印不透明度:65%

      • dissolve=65

    • 横轴边距:10

      • dx=10

    • 纵轴边距:10

      • dy=10

  • 水印文字：金山云

    • 原始水印文字=金山云

    • 加密水印文字(base64)=6YeR5bGx5LqR

    • text=6YeR5bGx5LqR

    • 水印位置:右上角

      • gravity=NorthEast

    • 水印不透明度:65%

      • dissolve=65

    • 横轴边距:50

      • dx=50

    • 纵轴边距:50

      • dy=50

请求代码



https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
  tag=imgWaterMark
  &type=1
  &dissolve=65
  &gravity=NorthEast
  &image=aHR0cDovL2tzMy1yZXNvdXJjZXMua3MzLWNuLWJlaWppbmcua3N5dW5jcy5jb20vZml4ZWRfa3NjX2xvZ28ucG5n
  &dy=10
  &dx=10
  tag=imgWaterMark
  &type=2
  &dissolve=65
  &gravity=NorthEast
  &text=6YeR5bGx5LqR
  &font=5b6u6L2v6ZuF6buR&fill=I2JmMTcxNw==&fontsize=500
  &dy=50
  &dx=50

注意：

  • 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

  • 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例

文档导读
上一篇：内切圆
下一篇：管道
纯净模式常规模式

纯净模式

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