調用AddImageMosaic實現圖片馬賽克高斯模糊與純色塊效果-Intelligent Media Management-阿里雲

在一張圖片的一個或多個特定地區內添加多種形狀的馬賽克、高斯模糊或純色塊，並將填充後的圖片儲存到指定的OSS檔案對象地址。該功能主要用於隱私保護。

介面說明

請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。
調用該介面前，請確保當前 Region 已經存在可用的專案（Project），詳見專案管理。
該介面支援的輸入圖片編碼格式為 jpg 與 png，單邊長不超過 30000 像素，總像素不超過 2.5 億像素。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

imm:AddImageMosaic

none

*Project

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

無

請求參數

名稱	類型	必填	描述	樣本值
ProjectName	string	是	專案名稱，擷取方式請參見建立專案。	test-project
SourceURI	string	是	源圖片的 OSS 地址。 OSS 地址規則為 oss://${Bucket}/${Object}，其中`${Bucket}`為和當前專案處於同一地區(Region)的 OSS Bucket 名稱，`${Object}`為包含副檔名的檔案完整路徑。支援的圖片格式：jpg，png，tiff，jp2，bmp。	oss://examplebucket/sampleobject.jpg
TargetURI	string	是	輸出圖片儲存的 OSS 地址。 OSS 地址規則為 oss://${Bucket}/${Object}，其中`${Bucket}`為和當前專案處於同一地區(Region)的 OSS Bucket 名稱，`${Object}`為包含副檔名的檔案完整路徑。	oss://examplebucket/outputImage.jpg
ImageFormat	string	否	圖片儲存時的編碼格式。可取值為 jpg、png、webp，預設與輸入圖片編碼格式相同。枚舉值： jpg : jpg png : png webp : webp	jpg
Quality	integer	否	輸出圖片的壓縮品質，僅限 jpg 和 webp 圖片格式。設定範圍為 0~100，預設為 80。	80
Targets	array<object>	是	處理框及操作類別參數數組。
	array<object>	否	處理框及操作類別參數。
Type	string	是	添加的馬賽克類型。可取值如下： square：方形的馬賽克 diamond：菱形的馬賽克 hexagon：正六邊形的馬賽克 blur：高斯模糊 pure：純色塊	square
Boundary	object	是	處理框位置資訊。
ReferPos	string	否	處理框在圖片上的基準位置。可取值如下： topright：右上方 topleft（預設）：左上方 bottomright：右下方 bottomleft：左下方	topleft
X	number	是	處理框相較於基準點的水平位移，不同取值的含義如下：取值為大於等於 0 的整數：表示距離基準位置的橫向距離，單位為 px。取值為小數：表示橫向距離像素值與圖片整體寬度的比值，取值範圍為[0,1)。	0
Y	number	是	處理框相較於基準點的垂直位移，不同取值的含義如下：取值為大於等於 0 的整數：表示距離基準位置的縱向距離，單位為 px。取值為小數：表示縱向距離像素值與圖片整體高度的比值，取值範圍為[0,1)。	0
Height	number	是	處理框的高，不同取值的含義如下：取值為大於等於 0 的整數：表示處理框高度，單位為 px。取值為小數：表示框縱向長度像素值與圖片整體高度的比值，取值範圍為[0,1)。	200
Width	number	是	處理框的寬，不同取值的含義如下：取值為大於等於 0 的整數：表示處理框寬度，單位為 px。取值為小數：表示框橫向長度像素值與圖片整體寬度的比值，取值範圍為[0,1)。	200
MosaicRadius	integer	否	馬賽克小塊的半徑大小。預設值為 5，單位為 px。說明該參數對於添加高斯模糊與純色塊不生效。	5
BlurRadius	integer	否	高斯模糊的模糊半徑，取值範圍為 1~50，預設值為 3，單位為 px。說明該參數僅在添加高斯模糊時生效。	3
Sigma	integer	否	高斯模糊的標準差，取值必須大於 0，預設值為 5。說明該參數僅在添加高斯模糊時生效。	5
Color	string	否	純色塊的顏色，支援`#FFFFFF`形式與預設的`red`、`white`等關鍵字。預設值為#FFFFFF，即白色。說明該參數僅在添加純色塊時生效。	#FFFFFF
CredentialConfig	CredentialConfig	否	如無特殊需求，請保持留空即可。鏈式授權配置，非必填。更多資訊，請參見使用鏈式授權訪問其他實體資源。

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	CA995EFD-083D-4F40-BE8A-BDF75FF*****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FF*****"
}

錯誤碼

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

變更歷史

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