圖片馬賽克

前提條件

• 已建立並擷取AccessKey。具體操作，請參見建立AccessKey。

• 已開通OSS服務、建立儲存空間並上傳檔案到儲存空間。具體操作，請參見控制台上傳檔案。

• 已開通Intelligent Media Management服務。具體操作，請參見開通產品。

• 已通過Intelligent Media Management控制台建立專案。具體操作，請參見建立專案。

  說明

  • 您也可以調用API介面建立專案。具體操作，請參見CreateProject - 建立專案。

  • 您可以調用ListProjects - 列出所有專案資訊的列表介面列出指定地區下已建立的所有專案資訊。

使用方法

調用AddImageMosaic - 添加圖片馬賽克介面對圖片進行模糊處理。

{
    "ProjectName": "test-project",
    "SourceURI": "oss://test-bucket/test-object.jpg",
    "TargetURI": "oss://test-bucket/test-target-object.jpg",
    "ImageFormat": "jpg",
    "Quality": "81",
    "Targets": "[{\"Type\": \"square\", \"Boundary\": {\"ReferPos\": \"topleft\", \"X\": 20, \"Y\": 20, \"Height\": 100, \"Width\": 100}, \"MosaicRadius\": 10, \"BlurRadius\": 5, \"Sigma\": 1, \"Color\": \"black\"}]"
}

{
  "RequestId" : "5F2389FE-A5E3-076F-B071-43A33*****",
}

範例程式碼

以Python SDK為例，圖片模糊處理的完整範例程式碼如下。

# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import sys
import os
from typing import List

from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        使用AccessKey ID&AccessKey Secret初始化帳號Client。
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        # 填寫訪問的IMM網域名稱。
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        # 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        # 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        # 本樣本通過從環境變數中讀取AccessKey，來實現API訪問的身分識別驗證。如何配置環境變數，請參見https://www.alibabacloud.com/help/document_detail/2361894.html。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        targets_0boundary = imm_20200930_models.AddImageMosaicRequestTargetsBoundary(
            refer_pos='topleft',
            x=20,
            y=20,
            height=100,
            width=100
        )
        targets_0 = imm_20200930_models.AddImageMosaicRequestTargets(
            boundary=targets_0boundary,
            type='square',
            mosaic_radius=10,
            blur_radius=5,
            sigma=1,
            color='black'
        )
        add_image_mosaic_request = imm_20200930_models.AddImageMosaicRequest(
            project_name='test-project',
            source_uri='oss://test-bucket/test-object.jpg',
            target_uri='oss://test-bucket/test-target-object.jpg',
            image_format='jpg',
            quality=81,
            targets=[
                targets_0
            ]
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印API的傳回值。
            client.add_image_mosaic_with_options(add_image_mosaic_request, runtime)
        except Exception as error:
            # 如有需要，請列印錯誤資訊。
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        # 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        # 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        # 本樣本通過從環境變數中讀取AccessKey，來實現API訪問的身分識別驗證。如何配置環境變數，請參見https://www.alibabacloud.com/help/document_detail/2361894.html。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        targets_0boundary = imm_20200930_models.AddImageMosaicRequestTargetsBoundary(
            refer_pos='topleft',
            x=20,
            y=20,
            height=100,
            width=100
        )
        targets_0 = imm_20200930_models.AddImageMosaicRequestTargets(
            boundary=targets_0boundary,
            type='square',
            mosaic_radius=10,
            blur_radius=5,
            sigma=1,
            color='black'
        )
        add_image_mosaic_request = imm_20200930_models.AddImageMosaicRequest(
            project_name='test-project',
            source_uri='oss://test-bucket/test-object.jpg',
            target_uri='oss://test-bucket/test-target-object.jpg',
            image_format='jpg',
            quality=81,
            targets=[
                targets_0
            ]
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印API的傳回值。
            await client.add_image_mosaic_with_options_async(add_image_mosaic_request, runtime)
        except Exception as error:
            # 如有需要，請列印錯誤資訊。
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

計費說明

在圖片馬賽克過程中，OSS 和 IMM 兩側會產生以下計費項目：

• OSS 側： 詳細定價請參見OSS產品定價。

  API	計費項目	說明
  GetObject	GET 類型請求	根據成功的請求次數計算請求費用。
  	低頻訪問資料取回容量	如果取回的資料是低頻訪問資料，會產生低頻訪問資料取回容量的費用，按資料取回量計費。
  	歸檔直讀資料取回容量	如果讀取的是歸檔的Object且Bucket開啟了歸檔直讀，會產生歸檔直讀資料取回容量費用，根據取回的資料容量大小計費。
  	傳輸加速	如果開啟了傳輸加速功能且使用傳輸加速網域名稱訪問您的Bucket會產生傳輸加速費用，根據資料容量大小計費。
  PutObject	PUT類型請求	根據成功的請求次數計算請求費用。
  	儲存費用	根據Object的儲存類型、大小和時間長度收取儲存費用。
  HeadObject	GET 類型請求	根據成功的請求次數計算請求費用。

• IMM 側： 詳細定價請參見IMM計費項目。

  重要

  自北京時間 2025 年 7 月 28 日 11:00 起，IMM 圖片馬賽克服務將由原來的免費模式升級為計費模式。更多資訊，請參見IMM計費調整公告。

  API	計費項目	說明
  AddImageMosaic	ImageMosaic	根據成功的請求次數計算圖片馬賽克的費用。