CreateDecodeBlindWatermarkTask - 建立解析盲浮水印任務 -

提取盲浮水印

介面說明

請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。
重要非同步任務不保證時效。
請確保已在Intelligent Media Management上正確建立了專案（ Project ），建立方式請參見建立專案。
請確保提取盲浮水印時使用的服務地區、專案與添加盲浮水印（ EncodeBlindWatermark ）時相同，否則無法提取。
當添加盲浮水印的圖片經過一定程度的攻擊後，例如壓縮、縮放、裁剪、色彩變換等，仍然可以提取出浮水印內容。
此介面相容舊版的盲浮水印功能，部分介面參數為舊版 DecodeBlindWatermark 介面的參數。
該介面為非同步介面，擷取任務開始執行後，任務資訊只儲存 7 天，超過 7 天則無法再擷取。調用 GetTask 或 ListTasks 介面擷取返回的 TaskId，查看任務資訊。也可以通過設定 Notification 訊息通知參數，通過訊息通知擷取任務資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

imm:CreateDecodeBlindWatermarkTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

無

請求參數

名稱	類型	必填	描述	樣本值
ProjectName	string	是	專案名稱，擷取方式請參見建立專案。重要專案名稱需要與添加盲浮水印（ EncodeBlindWatermark ）時相同，否則無法提取	immtest
SourceURI	string	是	圖片的 OSS 地址。 OSS 地址規則為`oss://<bucket>/<object>`，其中`<bucket>`為和當前專案處於同一地區的 OSS Bucket 名稱，`<object>`為包含副檔名的檔案完整路徑。	oss://target/sampleobject.jpg
StrengthLevel	string	否	浮水印提取等級，用於控制提取精度。等級越高，處理耗時越長，但提取效果越好。可取值如下： low。 medium。 high。	low
WatermarkType	string	否	嵌入的浮水印類型，可選值：text （圖片浮水印類型暫不支援，因此當前只能為 text）枚舉值： text : text	text
TargetURI	string	否	舊版盲浮水印 DecodeBlindWatermark 介面中的參數，解析盲浮水印後圖片儲存到的 OSS URI。 OSS 地址規則為`oss://<bucket>/<object>`，其中`<bucket>`為和當前專案處於同一地區的 OSS Bucket 名稱，`<object>`為包含副檔名的檔案完整路徑。	oss://target/targetobject.jpg
ImageQuality	integer	否	舊版盲浮水印 DecodeBlindWatermark 介面中的參數，輸出圖片的品質，預設值為 90，取值範圍為 70~100。品質越高，圖片尺寸越大，浮水印解析品質越高	90
Model	string	否	舊版盲浮水印 DecodeBlindWatermark 介面中的參數，浮水印演算法模型，可選值包括 FFT、FFT_FULL、DWT 和 DWT_IBG，其中預設參數為 FFT。當參數為空白時，表示新版，否則，則認為是舊版枚舉值： DWT : DWT FFT_FULL : FFT_FULL FFT : FFT DWT_IBG : DWT_IBG	FFT
OriginalImageURI	string	否	舊版盲浮水印 DecodeBlindWatermark 介面中的參數，添加盲浮水印前圖片的 OSS URI。當 Model 參數為 DWT 和 DWT_IBG 時無需設定此參數。 OSS 地址規則為`oss://<bucket>/<object>`，其中`<bucket>`為和當前專案處於同一地區的 OSS Bucket 名稱，`<object>`為包含副檔名的檔案完整路徑。	oss://imm-test/testcases/watermarktestbefore.jpg
Notification	Notification	否	訊息通知配置，詳細內容請單擊 Notification 查看，非同步通知訊息格式請參見非同步通知訊息格式。

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	當次請求的 Request ID。	4A7A2D0E-D8B8-4DA0-8127-EB32C6600ADE
EventId	string	事件 ID。	27C-1jyAP5qQI7RoI8lFFwvMrWtl0ft
TaskId	string	任務 ID。	DecodeBlindWatermark-78ac8f3b-59e0-45a6-9b67-32168c3f22b9

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4A7A2D0E-D8B8-4DA0-8127-EB32C6600ADE",
  "EventId": "27C-1jyAP5qQI7RoI8lFFwvMrWtl0ft",
  "TaskId": "DecodeBlindWatermark-78ac8f3b-59e0-45a6-9b67-32168c3f22b9"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。