GET /<ObjectKey>?watermark/1/image/<encodedURL>/gravity/<gravity>/dx/<dx>/dy/<dy>/blogo/<type> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations:{"is_pic_info": 1,"rules": [{"fileid": "exampleobject","rule": "watermark/1/image/<encodedURL>/gravity/<gravity>/dx/<dx>/dy/<dy>/blogo/<type>"}]}
POST /<ObjectKey>?image_process HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateContent-length: SizeAuthorization: Auth StringPic-Operations:{"is_pic_info": 1,"rules": [{"fileid": "exampleobject","rule": "watermark/1/image/<encodedURL>/gravity/<gravity>/dx/<dx>/dy/<dy>/blogo/<type>"}]}
Parameter | Description |
ObjectKey | Object name, such as folder/sample.jpg. |
/image/ | URL-safe Base64-encoded URL of the image watermark. For example, if the image watermark URL is http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png , you should set this parameter to aHR0cDovL2V4YW1wbGVidWNrZXQtMTI1MDAwMDAwMC5jb3MuYXAtc2hhbmdoYWkubXlxY2xvdWQuY29tL3NodWl5aW5fMi5wbmc. |
/gravity/ | |
/dx/ | Horizontal offset in pixels. Default value: 0 |
/dy/ | Vertical offset in pixels. Default value: 0 |
/blogo/ | Adaptation mode for an image watermark that is larger than the input image. Valid values: 1: scales the image watermark to the size of the input image. 2: crops the image watermark to the size of the input image. |
/scatype/ | Scaling mode for the image watermark (relative to the input image). This parameter must be used together with /spcent/ . Valid values:1: scales by width. 2: scales by height. 3: scales by area. |
/spcent/ | Scale ratio of the image watermark, in permillage. This parameter must be used together with /scatype/ . Value range:1−1000 (if /scatype/ is set to 1) 1−1000 (if /scatype/ is set to 2) 1−250 (if /scatype/ is set to 3)
Example: http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/1/image/xxxxxxx/scatype/3/spcent/250 |
/dissolve/ | Opacity of the image watermark. Value range: 1−100. Default value: 90 (meaning 90% opacity) |
/batch/ | Whether to tile the image watermark. If this parameter is set to 1, the image watermark will be tiled across the input image. |
/degree/ | Angle to rotate the image watermark. This parameter is valid only when /batch/ is set to 1. Value range: 0−360. Default value: 0 |
examplebucket-1250000000.file.myqcloud.com/shuiyin_2.png
is unsupported) and be accessible (if the image watermark is set to private-read, it must carry a signature).http://
. Note that “http://” cannot be omitted or changed to “https://”. For example, examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png
and https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png
are invalid watermark URLs.gravity
parameter for an operation, the corresponding red dot becomes the reference point, and offsets will be relative to this point.
gravity
is set to center
, dx
and dy
are invalid.gravity
is set to north
or south
, dx
is invalid.gravity
is set to west
or east
, dy
is invalid.http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
https://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast/batch/1/degree/45/dissolve/40/
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=AKID********************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=26a429871963375c88081ef60247c5746e834a98&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
Was this page helpful?