本文介紹圖像生產(chǎn)(imageenhan)類目下的圖像隱形圖片水印ImageBlindPicWatermark的語法及示例。

功能描述

圖像隱形圖片水印能力可以為圖像添加或解析圖片水印。

例如您有一張圖A,調(diào)用encode_pic參數(shù)添加圖片盲水印后得到圖B。或者您也可以將圖A作為OriginImageURL,將圖B作為WatermarkImageURL輸入,調(diào)用decode_pic參數(shù)就可以解析得到水印圖片。

說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當(dāng)前能力可在視覺智能開放平臺有完整的免費產(chǎn)品體驗,您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。

應(yīng)用場景

  • 著作權(quán)保護:圖片的作者依法享有著作權(quán)。在圖像中增加隱形水印,可以為圖片的作者或被授權(quán)人證明圖片的著作權(quán)歸屬,避免圖片在未獲得作者授權(quán)的情況下被非法使用。
  • 防止信息泄露:在涉密信息的圖片中,對不同的訪問者打上不同的隱形水印。如果圖片一旦被泄露,可以通過解析隱形水印,排查出泄密源。

特色優(yōu)勢

隱形水印與傳統(tǒng)圖章水印相比,其無法被觀看者察覺,不影響圖片效果。水印無法被使用者察覺,也無法通過普通的去水印方法去除,但可以通過圖像隱形圖片水印接口解析出水印,證明圖片的著作權(quán)歸屬。

接入指引

1. 注冊阿里云賬號:打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊,按照操作提示完成賬號注冊。

2. 開通能力:請確保您已開通圖像生產(chǎn)服務(wù),若未開通服務(wù)請立即開通

3. 創(chuàng)建AccessKey:請確保您已創(chuàng)建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請參見RAM授權(quán)。

4. 在線調(diào)試(可選):您可以通過OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。

5. 開發(fā)接入步驟:

  • SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應(yīng)語言的SDK文檔中找到AI類目為圖像生產(chǎn)(imageenhan)的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當(dāng)修改后調(diào)用。

6. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。

輸入限制

  • 圖像格式:JPEG、JPG、PNG、BMP。
  • 圖像大小:不超過3 MB。
  • 圖像分辨率:大于5×5像素。
  • URL地址中不能包含中文字符。

計費說明

關(guān)于圖像隱形圖片水印的計費方式及報價,請參見計費介紹。

說明 下方調(diào)試接口為付費接口,如需免費體驗調(diào)試請前往體驗中心

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String ImageBlindPicWatermark

系統(tǒng)規(guī)定參數(shù)。取值:ImageBlindPicWatermark。

FunctionType String encode_pic

指定調(diào)用功能。包括:

  • encode_pic:為采用老版本模型添加圖像水印。
  • encode_pic_plus:為采用新版本模型1添加圖像水印。
  • encode_pic_bold:為采用新版本模型2添加圖像水印。
  • decode_pic:為采用老版本模型解碼圖像中的圖像水印,對應(yīng)加水印方法encode_pic。
  • decode_pic_plus:為采用新版本模型1解碼圖像中的圖像水印,對應(yīng)加水印方法encode_pic_plus。
  • decode_pic_bold:為采用新版本模型2解碼圖像中的圖像水印,對應(yīng)加水印方法encode_pic_bold。
LogoURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxxx.jpg

待添加的水印圖片URL。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。

說明
  • 當(dāng)FunctionType為encode_pic、encode_pic_plusencode_pic_bold時,該參數(shù)必填。
  • 當(dāng)FunctionType為decode_picdecode_pic_plusdecode_pic_bold時,該參數(shù)不填。
WatermarkImageURL String https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imageenhan/xxxxx.jpg

待解析圖,即帶有圖片水印的合成圖。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。

說明
  • 當(dāng)FunctionType為decode_pic、decode_pic_plusdecode_pic_bold時,該參數(shù)必填。
  • 當(dāng)FunctionType為encode_picencode_pic_plusencode_pic_bold時,該參數(shù)不填。
OutputFileType String jpg

輸出圖格式。可以選擇jpeg、pngjpg、bmp四種格式,默認(rèn)png。

說明
  • 當(dāng)FunctionType為encode_picencode_pic_plusencode_pic_bold時,該參數(shù)必填。
  • 當(dāng)FunctionType為decode_pic、decode_pic_plusdecode_pic_bold時,該參數(shù)不填。
QualityFactor Integer 100

輸出圖像的質(zhì)量大小。圖像越大質(zhì)量越高,取值范圍1~100,默認(rèn)100。

說明 僅當(dāng)OutputFileType為jpg時有效。
OriginImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxxx.jpg

原始圖像。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理

說明
  • 當(dāng)FunctionType為encode_pic、encode_pic_plus、encode_pic_bolddecode_pic時,該參數(shù)必填。
  • 當(dāng)FunctionType為decode_pic_plusdecode_pic_bold時,該參數(shù)不填。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String DE7869E4-0ACE-4C02-8B98-540B49F49205

請求ID。

Data Object

返回的結(jié)果數(shù)據(jù)內(nèi)容。

WatermarkImageURL String http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&Expires=158340****&Signature=Heet1ivG0xFP3YlO6usvd0pmrH****

當(dāng)調(diào)用功能為encode_picencode_pic_plus時,返回帶有添加水印的圖像URL地址。

說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內(nèi)訪問URL地址,下載文件轉(zhuǎn)存到自己的OSS或者其他存儲空間。
LogoURL String http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&Expires=158340****&Signature=Heet1ivG0xFP3YlO6usvd0pmrH****

當(dāng)調(diào)用功能為decode_picdecode_pic_plus時,返回解碼后的水印圖像URL地址。

說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內(nèi)訪問URL地址,下載文件轉(zhuǎn)存到自己的OSS或者其他存儲空間。

SDK參考

阿里云視覺AI圖像生產(chǎn)類目下的圖像標(biāo)志擦除能力推薦使用SDK調(diào)用,支持多種編程語言,調(diào)用時請選擇AI類目為圖像生產(chǎn)(imageenhan)的SDK包,文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL,具體可參見SDK總覽

示例

請求示例

http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=ImageBlindPicWatermark      //更多關(guān)于訪問域名(Endpoint)信息,請參見:http://m.bestwisewords.com/document_detail/143103.html
&FunctionType=encode_pic
&LogoURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxxx.jpg
&WatermarkImageURL=https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imageenhan/xxxxx.jpg
&OutputFileType=jpg
&QualityFactor=100
&OriginImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxxx.jpg
&公共請求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>DE7869E4-0ACE-4C02-8B98-540B49F49205</RequestId>
<Data>
    <WatermarkImageURL>http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&amp;Expires=158340****&amp;Signature=Heet1ivG0xFP3YlO6usvd0pmrH****</WatermarkImageURL>
    <LogoURL>http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&amp;Expires=158340****&amp;Signature=Heet1ivG0xFP3YlO6usvd0pmrH****</LogoURL>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "DE7869E4-0ACE-4C02-8B98-540B49F49205",
  "Data" : {
    "WatermarkImageURL" : "http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&amp;Expires=158340****&amp;Signature=Heet1ivG0xFP3YlO6usvd0pmrH****",
    "LogoURL" : "http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI4Fmdm1gQonFLrghJ****&amp;Expires=158340****&amp;Signature=Heet1ivG0xFP3YlO6usvd0pmrH****"
  }
}

錯誤碼

關(guān)于圖像隱形圖片水印的錯誤碼,詳情請參見常見錯誤碼

安全聲明

  • 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
  • 通過體驗調(diào)試上傳的臨時文件有效期為1小時,在24小時后會被系統(tǒng)自動清理刪除。