使用場景

• 版權保護：為保護自己的作品不被未授權使用或復制，需要在圖片上加上水印來標識版權。

• 品牌推廣：企業或個人為了宣傳自己的品牌或標識，會在圖片、視頻或文檔上加上帶有品牌標志或名稱的水印。

• 防止篡改：在某些官方文件、證書或報告上添加水印，可以增加篡改的難度，減少文件被偽造的風險。

• 抵制盜圖：在網絡環境中，圖片很容易被他人下載和再次發布。加水印可以作為一種警示，減少他人直接盜用圖片的情況。

• 法律要求：某些情況下，法律或合同條款可能要求在特定內容發布時必須加上水印，以符合規定。

注意事項

• 您可以通過文件URL、SDK、API方式設置圖片處理參數。本文以文件URL為例進行介紹。文件URL僅適用于公共訪問的圖片。如果是私有訪問的圖片，請使用SDK、API處理圖片。更多信息，請參見圖片處理操作方式。

• 圖片水印只能使用當前存儲空間內的圖片，網絡或本地圖片需上傳至當前存儲空間內方可使用。

• 圖片水印目前僅支持JPG、PNG、BMP、WebP、TIFF格式。

• 單張圖片最多支持添加3張不同的圖片水印，且各個圖片水印的位置不能完全重疊。

• 文字水印暫不支持繁體中文。

參數說明

操作名稱：watermark

相關參數如下：

• 基礎參數

  參數	是否必須	描述	取值范圍
  t	否	指定圖片水印或水印文字的透明度。	[0,100] 默認值：100， 表示透明度100%（不透明）。
  g	否	指定水印在圖片中的位置。	nw：左上 north：中上 ne：右上 west：左中 center：中部 east：右中 sw：左下 south：中下 se（默認值）：右下 詳情請參見下方基準點圖片。
  x	否	指定水印的水平邊距， 即距離圖片邊緣的水平距離。這個參數只有當水印位置是左上、左中、左下、右上、右中、右下才有意義。	[0,4096] 默認值：10 單位：像素（px）
  y	否	指定水印的垂直邊距，即距離圖片邊緣的垂直距離， 這個參數只有當水印位置是左上、中上、右上、左下、中下、右下才有意義。	[0,4096] 默認值：10 單位：像素（px）
  voffset	否	指定水印的中線垂直偏移。當水印位置在左中、中部、右中時，可以指定水印位置根據中線往上或者往下偏移。	[-1000,1000] 默認值：0 單位：像素（px）
  fill	否	指定是否將圖片水印或文字水印鋪滿原圖。 說明 如果您需要使用圖片水印平鋪功能，請在配額中心申請。	1：將圖片水印或文字水印鋪滿原圖。 0（默認值）：不將圖片水印或文字水印鋪滿全圖。
  padx	否	水印平鋪時單個水印間的水平間隔。僅在水印平鋪開啟時有效。	[0,4096] 默認值：0 單位：像素（px）
  pady	否	水印平鋪時單個水印間的垂直間隔。僅在水印平鋪開啟時有效。	[0,4096] 默認值：0 單位：像素（px）

  水平邊距、垂直邊距、中線垂直偏移不僅可以調節水印在圖片中的位置，當圖片存在多重水印時，還可以調節水印在圖中的布局。

  區域數值以及每個區域對應的基準點如下圖所示。

• 圖片水印參數

  參數	是否必須	描述	取值范圍
  image	是	用于指定作為圖片水印Object的完整名稱，Object名稱需進行Base64編碼。詳情請參見水印編碼。 例如，作為圖片水印的Object為Bucket內image目錄下的panda.png，則需要編碼的內容為image/panda.png，編碼后的字符串為aW1hZ2UvcGFuZGEucG5n。 說明 水印圖片只能使用當前存儲空間內的Object。	Base64編碼后的字符串。

• 水印圖片預處理參數

  您可以使用圖片縮放、自定義裁剪、索引切割、圓角矩形及圖片旋轉操作中的所有參數對水印圖片進行預處理。此外，水印圖片在進行預處理時，還額外支持縮放參數P：

  參數	描述	取值范圍
  P	指定圖片水印按照要添加水印的原圖的比例進行縮放，取值為縮放的百分比。如設置參數值為10，如果原圖為100×100， 則圖片水印大小為10×10。當原圖變成了200×200，則圖片水印大小為20×20。	[1,100]

• 文字水印參數

  參數	是否必須	描述	取值范圍
  text	是	指定文字水印的文字內容，文字內容需進行Base64編碼。詳情請參見水印編碼。	Base64編碼之前中文字符串的最大字節長度為64個字符。
  type	否	指定文字水印的字體，字體名稱需進行Base64編碼。	支持的字體及字體編碼詳情請參見文字類型編碼對應表。 默認值：wqy-zenhei（ 編碼后的值為d3F5LXplbmhlaQ）
  color	否	指定文字水印的文字顏色，參數值為RGB顏色值。	RGB顏色值，例如：000000表示黑色，FFFFFF表示白色。 默認值：000000（黑色）
  size	否	指定文字水印的文字大小。	(0,1000] 默認值：40 單位：px
  shadow	否	指定文字水印的陰影透明度。	[0,100] 默認值：0，表示沒有陰影。
  rotate	否	指定文字順時針旋轉角度。	[0,360] 默認值：0，表示不旋轉。

  type參數中可選的文字類型及編碼如下表所示。

  參數值	中文含義	編碼值
  wqy-zenhei	文泉驛正黑	d3F5LXplbmhlaQ
  wqy-microhei	文泉微米黑	d3F5LW1pY3JvaGVp
  fangzhengshusong	方正書宋	ZmFuZ3poZW5nc2h1c29uZw
  fangzhengkaiti	方正楷體	ZmFuZ3poZW5na2FpdGk
  fangzhengheiti	方正黑體	ZmFuZ3poZW5naGVpdGk
  fangzhengfangsong	方正仿宋	ZmFuZ3poZW5nZmFuZ3Nvbmc
  droidsansfallback	DroidSansFallback	ZHJvaWRzYW5zZmFsbGJhY2s

• 圖文混合水印參數

  參數	是否必須	描述	取值范圍
  order	否	指定文字和圖片水印的前后順序。	0、1 0（默認值）：表示圖片水印在前。 1：表示文字水印在前。
  align	否	指定文字水印和圖片水印的對齊方式。	0、1、2 0：表示文字水印和圖片水印上對齊。 1：表示文字水印和圖片水印中對齊。 2（默認值）：表示文字水印和圖片水印下對齊。
  interval	否	指定文字水印和圖片水印間的間距。	[0,1000] 默認值：0 單位：px

水印編碼

在添加水印操作中，文字水印的文字內容、文字字體、圖片水印的水印圖片名稱等參數需要進行URL安全的Base64編碼。編碼步驟如下：

1. 將內容編碼成Base64。

2. 將結果中的部分編碼替換。

   • 將結果中的加號（+）替換成短劃線（-）。

   • 將結果中的正斜線（/）替換成下劃線（_）。

   • 將結果中尾部的所有等號（=）省略。

推薦通過base64url encoder對文字水印的文字內容、文字顏色、文字字體、圖片水印的水印圖片名稱等參數進行編碼。

操作方式

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GetObjectRequest;
import java.io.File;

public class Demo {
    public static void main(String[] args) throws Throwable {
        // Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 填寫Endpoint對應的Region信息，例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填寫Bucket名稱，例如examplebucket。
        String bucketName = "examplebucket";
        // 填寫Object完整路徑。Object完整路徑中不能包含Bucket名稱。
        String objectName = "src.jpg";
        // 填寫本地文件的完整路徑，例如D:\\localpath\\example-new.jpg。如果指定的本地文件存在會覆蓋，不存在則新建。
        String pathName = "D:\\dest.jpg";

        // 創建OSSClient實例。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 為圖片添加Hello World文字水印。
            String image = "image/watermark,text_SGVsbG8gV29ybGQ";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 將處理后的圖片命名為example-new.jpg并保存到本地。
            // 如果未指定本地路徑只填寫了文件名稱（例如example-new.jpg），則文件默認保存到示例程序所屬項目對應本地路徑中。
            ossClient.getObject(request, new File("D:\\dest.jpg"));
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;

// 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱，例如examplebucket。
$bucket= "examplebucket";
// 填寫Object完整路徑，例如exampledir/exampleobject.jpg。Object完整路徑中不能包含Bucket名稱。
$object = "src.jpg";
// 填寫本地文件的完整路徑，例如D:\\localpath\\example-new.jpg。如果指定的本地文件存在會覆蓋，不存在則新建。
// 如果未指定本地路徑只填寫了本地文件名稱（例如example-new.jpg），則文件默認保存到示例程序所屬項目對應本地路徑中。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // 填寫阿里云通用Region ID。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// 為圖片添加Hello World的文字水印。
$image = "image/watermark,text_SGVsbG8gV29ybGQ";

$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => $image);

// 將處理后的圖片保存到本地。
$ossClient->getObject($bucket, $object, $options);                           

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
## 填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# 填寫阿里云通用Region ID。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
# 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
key = 'src.jpg'
# 指定處理后的圖片名稱。
new_pic = 'D:\\dest.jpg'

# 為圖片添加Hello World的文字水印。
image = 'image/watermark,text_SGVsbG8gV29ybGQ'
bucket.get_object_to_file(key, new_pic, process=image)

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 創建OSSClient實例。
	// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
	if err != nil {
		HandleError(err)
	}

	// 指定原圖所在的Bucket名稱，例如examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
	sourceImageName := "src.jpg"
	// 指定處理后的圖片名稱。
	targetImageName := "D://dest.jpg"
	// 為圖片添加Hello World的文字水印。
	image := "image/watermark,text_SGVsbG8gV29ybGQ"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

GET /oss.jpg?x-oss-process=image/watermark,w_100 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************

常見問題

如何使用網絡圖片或本地圖片作為水印圖片？

通過OSS的圖片處理為圖片添加圖片水印時，僅可以使用相同存儲空間內的圖片作為水印圖片。若您希望使用網絡圖片或本地圖片作為水印圖片，需要先將圖片上傳到原圖所在存儲空間，之后再使用上傳的圖片作為水印圖片處理原圖。

添加文字水印時提示“font content is too large”怎么辦？

通過OSS的圖片處理為圖片添加文字水印時，最長不能超過64個字符（1個漢字計為3個字符）。當提示“font content is too large”時，建議您縮短文字長度，然后為圖片添加文字水印。更多信息，請參見示例一：添加文字水印。

私有文件添加圖片水印失敗怎么辦？

私有文件的訪問URL帶有簽名。OSS不支持在帶簽名的URL后直接添加圖片處理參數。如果您想要對私有文件進行圖片處理，需要將圖片處理參數加入到簽名中。更多信息，請參見生成帶圖片處理參數的文件簽名URL。

添加圖片水印時可以為水印增加背景色么？

不可以。

如何使用簽名URL訪問圖片？

私有文件的訪問URL帶有簽名。OSS不支持在帶簽名的URL后直接添加圖片處理參數。如果您想要對私有文件進行圖片處理，需要將圖片處理參數加入到簽名中。更多信息，請參見圖片處理。

添加水印時支持垂直排列么？

如果您希望在添加水印時垂直排列，可以拆分成多個水印操作，通過多個watermark算子實現垂直排列效果。

例如：https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,text_SGVsbG8gV29ybGQ/watermark,text_SGVsbG8gV29ybGQy,y_60

如何根據圖片的大小動態調整水印的大小？

OSS的圖片處理不支持動態調整水印的大小，在實際應用中，您可能需要編寫自定義邏輯來檢測圖片的尺寸，然后根據一定的比例或規則來決定文字水印的大小。這一步驟需要您在調用OSS接口前，在客戶端或服務端代碼中實現。

可以同時為圖片增加幾個水印？

3個。如果您需要為圖片增加更多水印，請提交工單申請。