すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ぼかし

最終更新日:Jun 28, 2025

Object Storage Service (OSS) に保存されているイメージの機密情報を保護したり、視覚効果を向上させたりするには、イメージ全体またはイメージの一部をぼかすことができます。

シナリオ

  • プライバシー保護: ナンバープレートや顔などの機密情報が含まれているイメージを公開する前に、イメージの一部をぼかすことができます。

  • 複数のレイヤーで構成されたイメージの視覚体験の向上: イメージを適切にぼかすことで、異なるレイヤー間のエッジを滑らかにし、より快適な視覚体験を提供できます。

  • 低解像度イメージの表示の向上: イメージの解像度が低く、高解像度ディスプレイの要件を満たせない場合は、イメージをぼかすことができます。

方法

オブジェクト URL と OSS SDK を使用するか、API オペレーションを呼び出して、イメージの処理に使用するイメージ処理 (IMG) パラメーターを設定できます。 オブジェクト URL を使用して IMG パラメーターを設定できるのは、公開読み取りまたは公開読み書きのイメージの場合のみです。 非公開イメージの IMG パラメーターを設定する場合は、OSS SDK を使用するか、API オペレーションを呼び出します。 詳細については、「IMG の実装モード」をご参照ください。

公開読み取りまたは公開読み書きのイメージをぼかす

処理するイメージオブジェクトのアクセス制御リスト (ACL) が公開読み取りまたは公開読み書きの場合は、オブジェクトの URL に IMG パラメーターを追加して、匿名ユーザーが処理済みオブジェクトにアクセスできるようにすることができます。

この例では、パブリック読み取りイメージの URL の末尾に ?x-oss-process=image/blur,parame_value が追加されています。parame_value を、ビジネス要件に基づいて パラメーター セクションで説明されている特定のパラメーターと値に置き換えるだけです。URL に複数のパラメーターを追加できます。

ソースイメージの URL

ソースイメージの処理に使用する URL

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/blur,r_10,s_10

非公開イメージをぼかす

OSS SDK の使用

次のサンプルコードは、一般的なプログラミング言語の OSS SDK を使用して非公開イメージをぼかす方法の例を示しています。 他のプログラミング言語を使用して非公開イメージをぼかす方法の詳細については、「概要」をご参照ください。

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
        // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントを使用しています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // 処理するイメージのフルパスを指定します。フルパスにバケット名を含めないでください。
        String objectName = "src.jpg";
        // 処理済みイメージを保存するフルパスを指定します。例: D:\\localpath\\example-new.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。そうでない場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";

        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // ぼかし半径を 10 に、正規分布の標準偏差を 10 に設定します。
            String image = "image/blur,r_10,s_10";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージの名前を dest.jpg に設定し、ローカルコンピューターに保存します。
            // ローカルパスを指定せずに、dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// オブジェクトの完全なパスを指定します。 例: exampledir/exampleobject.jpg。 完全なパスにバケット名を含めないでください。
$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,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// ぼかし半径を 10 に設定し、正規分布の標準偏差を 10 に設定します。
$image = "image/blur,r_10,s_10";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
# 処理するイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
key = 'src.jpg'
# 処理済みイメージの名前を指定します。
new_pic = 'D:\\dest.jpg'

# ぼかし半径を 10 に設定し、正規分布の標準偏差を 10 に設定します。
image = 'image/blur,r_10,s_10'
bucket.get_object_to_file(key, new_pic, process=image)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "src.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// ぼかし半径を 10 に設定し、正規分布の標準偏差を 10 に設定します。
	image := "image/blur,r_10,s_10"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

OSS API の使用

ビジネスで高度なカスタマイズが必要な場合は、RESTful API オペレーションを直接呼び出すことができます。 API を直接呼び出すには、コードに署名計算を含める必要があります。 Authorization ヘッダーの計算方法の詳細については、「(推奨) Authorization ヘッダーに V4 署名を含める」をご参照ください。

GetObject オペレーションでぼかしパラメーターを指定して、非公開イメージをぼかすことができます。 詳細については、「GetObject」をご参照ください。

GET /oss.jpg?x-oss-process=image/blur,r_10,s_10 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue

非公開イメージをぼかす (バケットを IMM プロジェクトにバインドする)

g_face または g_faces パラメーターを使用して非公開イメージをぼかす前に、非公開イメージが保存されているバケットを Intelligent Media Management (IMM) プロジェクトにバインドする必要があります。 詳細については、「はじめに」をご参照ください。

OSS SDK の使用

次のサンプルコードは、一般的なプログラミング言語の OSS SDK を使用して非公開イメージをぼかす方法の例を示しています。 他のプログラミング言語を使用して非公開イメージをぼかす方法の詳細については、「概要」をご参照ください。

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
        // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントを使用しています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // ソースイメージの完全なパスを指定します。完全なパスにバケット名を含めないでください。
        String objectName = "example.jpg";
        // 処理済みイメージを保存する完全なパスを指定します。例: D:\\dest.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。それ以外の場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";

        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // ぼかしの範囲をすべての人間の顔に設定します。すべての人間の顔のぼかし半径を 25 に、正規分布の標準偏差を 50 に設定します。
            String image = "image/blur,g_faces,r_25,s_50";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージをローカルコンピュータに保存します。
            // 処理済みイメージの名前 (dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// ソースイメージの完全なパスを指定します。 完全なパスにバケット名を含めないでください。
$object = "src.jpg";
// 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\dest.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
// ローカルパスを指定せずに、dest.jpg などの処理済みイメージの名前のみを指定すると、処理済みイメージはサンプルプログラムが属するプロジェクトのローカルパスに保存されます。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// ぼかしの範囲をすべての人間の顔に設定します。 すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
$image = "image/blur,g_faces,r_25,s_50";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

# ソースイメージがバケットのルートディレクトリに保存されている場合は、イメージ名のみを指定できます。 例: source-example.jpg。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、ソースイメージの完全なパスを指定する必要があります。 例: exampledir/source-example.jpg。
key = 'source-example.jpg'

# 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\target-example.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
local_file_name = 'D:\\target-example.jpg'

# ぼかしの範囲をすべての人間の顔に設定します。 すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
process = 'image/blur,g_faces,r_25,s_50'

# get_object メソッドを使用し、process パラメーターを使用して処理命令を渡します。
result = bucket.get_object_to_file(key, local_file_name, process=process)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "example.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// ぼかしの範囲をすべての人間の顔に設定します。 すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
	image := "image/blur,g_faces,r_25,s_50"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

OSS API の使用

ビジネスで高度なカスタマイズが必要な場合は、RESTful API オペレーションを直接呼び出すことができます。 API を直接呼び出すには、コードに署名計算を含める必要があります。 Authorization ヘッダーの計算方法の詳細については、「(推奨) Authorization ヘッダーに V4 署名を含める」をご参照ください。

GetObject オペレーションでぼかしパラメーターを指定して、非公開イメージをぼかすことができます。 詳細については、「GetObject」をご参照ください。

GET /oss.jpg?x-oss-process=image/blur,g_faces,r_25,s_50 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue

パラメーター

アクション: ぼかし

次の表は、イメージをぼかすために設定できるパラメーターを示しています。

パラメーター

必須

説明

有効な値

r

はい

ぼかし半径。

[1,50]

値が大きいほど、イメージがぼやけます。

s

はい

正規分布の標準偏差。

[1,50]

値が大きいほど、イメージがぼやけます。

g

いいえ

ぼかしの範囲を指定します。

  • face: イメージ内の最大の顔。

  • faces: イメージ内のすべての顔。

説明
  • 最初に、イメージが保存されているバケットを IMM プロジェクトにバインドする必要があります。 OSS コンソールを使用してバケットを IMM プロジェクトにバインドする方法の詳細については、「はじめに」をご参照ください。 API オペレーションを使用してバケットを IMM プロジェクトにバインドする方法の詳細については、「AttachOSSBucket」をご参照ください。

  • 匿名アクセスはサポートされていません。

  • OSS で IMM 機能を使用するために必要な権限を持っている必要があります。 詳細については、「権限」をご参照ください。

p

いいえ

ぼかし領域のサイズ変更パラメーター。

[1,200]

単位: %。

説明

このパラメーターは、g_face または g_faces が指定されている場合にのみ有効です。

イメージ全体をぼかす

次のパラメーターを設定します。

  • 操作を指定: blur

  • ぼかしの半径を 10 に設定し、正規分布の標準偏差を 10 に設定 (r_10,s_10)

パブリック読み取りまたはパブリック読み取り/書き込みイメージの場合、イメージ URL の末尾に ?x-oss-process=image/blur,r_10,s_10 を追加できます。その後、OSS は指定されたパラメータに基づいてイメージをリアルタイムで処理し、処理されたイメージを返します。非公開イメージをぼかす方法の詳細については、「非公開イメージをぼかす」をご参照ください。

サンプル効果

次の例では、ソースイメージの URL の末尾に ?x-oss-process=image/blur,r_10,s_10 を追加することで、ソースイメージをぼかす方法について説明します。

ソースイメージ

処理済みイメージ

原图

模糊1

ソースイメージの URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

イメージの処理に使用する URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/blur,r_10,s_10

イメージ内の最大の人間の顔をぼかす

次のパラメーターを設定します。

  • 操作を指定: blur

  • 最大の人間の顔をぼかす: g_face

  • ぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定: r_25,s_50

OSS SDK を使用してイメージを処理するには、バケットを IMM プロジェクトにバインドする必要があります。

サンプルコード

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
        // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントが使用されています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // ソースイメージのフルパスを指定します。フルパスにバケット名を含めないでください。
        String objectName = "example.jpg";
        // 処理済みイメージを保存するフルパスを指定します。例: D:\\dest.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。そうでない場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";

        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 最大の人間の顔のぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
            String image = "image/blur,g_face,r_25,s_50";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージをローカルコンピュータに保存します。
            // ローカルパスを指定せずに、dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// ソースイメージの完全なパスを指定します。 完全なパスにバケット名を含めないでください。
$object = "src.jpg";
// 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\dest.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
// ローカルパスを指定せずに、dest.jpg などの処理済みイメージの名前のみを指定すると、処理済みイメージはサンプルプログラムが属するプロジェクトのローカルパスに保存されます。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
$image = "image/blur,g_face,r_25,s_50";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

# ソースイメージがバケットのルートディレクトリに保存されている場合は、イメージ名のみを指定できます。 例: source-example.jpg。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、ソースイメージの完全なパスを指定する必要があります。 例: exampledir/source-example.jpg。
key = 'source-example.jpg'

# 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\target-example.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
local_file_name = 'D:\\target-example.jpg'

# 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
process = 'image/blur,g_face,r_25,s_50'

# get_object メソッドを使用し、process パラメーターを使用してカスタム切り抜き操作を渡します。
result = bucket.get_object_to_file(key, local_file_name, process=process)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "example.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
	image := "image/blur,g_face,r_25,s_50"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

サンプル効果

次の表は、image/blur,g_face,r_25,s_50 パラメータを使用して処理されたソースイメージとイメージを示しています。

ソースイメージ

処理済みイメージ

原图

image

イメージ内のすべての人間の顔をぼかす

次のパラメーターを設定します。

  • 操作を指定: blur

  • すべての人の顔をぼかす: g_face

  • ぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定: r_25,s_50

OSS SDK を使用してイメージを処理するには、バケットを IMM プロジェクトにバインドする必要があります。

サンプルコード

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
       // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントが使用されています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // ソースイメージのフルパスを指定します。フルパスにバケット名を含めないでください。
        String objectName = "example.jpg";
        // 処理済みイメージを保存するフルパスを指定します。例: D:\\dest.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。そうでない場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";


        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // すべての人間の顔のぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
            String image = "image/blur,g_faces,r_25,s_50";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージをローカルコンピュータに保存します。
            // ローカルパスを指定せずに、dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// ソースイメージの完全なパスを指定します。 完全なパスにバケット名を含めないでください。
$object = "src.jpg";
// 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\dest.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
// ローカルパスを指定せずに、dest.jpg などの処理済みイメージの名前のみを指定すると、処理済みイメージはサンプルプログラムが属するプロジェクトのローカルパスに保存されます。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
$image = "image/blur,g_faces,r_25,s_50";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

# ソースイメージがバケットのルートディレクトリに保存されている場合は、イメージ名のみを指定できます。 例: source-example.jpg。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、ソースイメージの完全なパスを指定する必要があります。 例: exampledir/source-example.jpg。
key = 'source-example.jpg'

# 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\target-example.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
local_file_name = 'D:\\target-example.jpg'

# すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
process = 'image/blur,g_faces,r_25,s_50'

# get_object メソッドを使用し、process パラメーターを使用してカスタム切り抜き操作を渡します。
result = bucket.get_object_to_file(key, local_file_name, process=process)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "example.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定します。
	image := "image/blur,g_faces,r_25,s_50"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

サンプル効果

次の表は、image/blur,g_faces,r_25,s_50 パラメータを使用して処理されたソースイメージとイメージを示しています。

ソースイメージ

処理済みイメージ

原图

image

イメージ内の最大の人間の顔をぼかし、ぼかし領域を最大の顔の 2 倍のサイズに拡大する

次のパラメーターを設定します。

  • 操作を指定: blur

  • 最大の人間の顔をぼかす: g_face

  • ぼかし領域を最大の顔の 2 倍のサイズに拡大する: p_200

  • ぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定: r_25,s_50

OSS SDK を使用してイメージを処理するには、バケットを IMM プロジェクトにバインドする必要があります。

サンプルコード

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
        // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントが使用されています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // ソースイメージのフルパスを指定します。フルパスにバケット名を含めないでください。
        String objectName = "example.jpg";
        // 処理済みイメージを保存するフルパスを指定します。例: D:\\dest.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。そうでない場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";

        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 最大の人間の顔のぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を最大の顔の 2 倍のサイズに拡大します。
            String image = "image/blur,g_face,p_200,r_25,s_50";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージをローカルコンピュータに保存します。
            // ローカルパスを指定せずに、dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// ソースイメージの完全なパスを指定します。 完全なパスにバケット名を含めないでください。
$object = "src.jpg";
// 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\dest.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
// ローカルパスを指定せずに、dest.jpg などの処理済みイメージの名前のみを指定すると、処理済みイメージはサンプルプログラムが属するプロジェクトのローカルパスに保存されます。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を最大の顔の 2 倍のサイズに拡大します。
$image = "image/blur,g_face,p_200,r_25,s_50";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

# ソースイメージがバケットのルートディレクトリに保存されている場合は、イメージ名のみを指定できます。 例: source-example.jpg。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、ソースイメージの完全なパスを指定する必要があります。 例: exampledir/source-example.jpg。
key = 'source-example.jpg'

# 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\target-example.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
local_file_name = 'D:\\target-example.jpg'

# 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を最大の顔の 2 倍のサイズに拡大します。
process = 'image/blur,g_face,p_200,r_25,s_50'

# get_object メソッドを使用し、process パラメーターを使用してカスタム切り抜き操作を渡します。
result = bucket.get_object_to_file(key, local_file_name, process=process)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "example.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// 最大の人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を最大の顔の 2 倍のサイズに拡大します。
	image := "image/blur,g_face,p_200,r_25,s_50"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

サンプル効果

次の表は、image/blur,g_face,p_200,r_25,s_50 パラメータを使用して処理されたソースイメージとイメージを示しています。

ソースイメージ

処理済みイメージ

原图

image

イメージ内のすべての人間の顔をぼかし、ぼかし領域を顔の 2 倍のサイズに拡大する

次のパラメーターを設定します。

  • 操作を指定: blur

  • すべての人の顔をぼかす: g_face

  • ぼかし領域を顔の 2 倍のサイズに拡大する: p_200

  • ぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定: r_25,s_50

OSS SDK を使用してイメージを処理するには、バケットを IMM プロジェクトにバインドする必要があります。

サンプルコード

Java

OSS SDK for Java 3.17.4 以降が必要です。

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 {
        // リージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのエンドポイントが使用されています。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // バケットが配置されているリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // ソースイメージのフルパスを指定します。フルパスにバケット名を含めないでください。
        String objectName = "example.jpg";
        // 処理済みイメージを保存するフルパスを指定します。例: D:\\dest.jpg。パスに同じ名前のイメージが既に存在する場合、処理済みイメージは既存のイメージを上書きします。そうでない場合、処理済みイメージはパスに保存されます。
        String pathName = "D:\\dest.jpg";

        // OSSClient インスタンスを作成します。
        // OSSClient が不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // すべての人間の顔のぼかしの半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を顔の 2 倍のサイズに拡大します。
            String image = "image/blur,g_faces,p_200,r_25,s_50";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 処理済みイメージをローカルコンピュータに保存します。
            // ローカルパスを指定せずに、dest.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

OSS SDK for PHP 2.7.0 以降が必要です。

<?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();
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// ソースイメージの完全なパスを指定します。 完全なパスにバケット名を含めないでください。
$object = "src.jpg";
// 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\dest.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
// ローカルパスを指定せずに、dest.jpg などの処理済みイメージの名前のみを指定すると、処理済みイメージはサンプルプログラムが属するプロジェクトのローカルパスに保存されます。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を顔の 2 倍のサイズに拡大します。
$image = "image/blur,g_faces,p_200,r_25,s_50";

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

// 処理済みイメージをローカルコンピューターに保存します。
$ossClient->getObject($bucket, $object, $options);                           

Python

OSS SDK for Python 2.18.4 以降が必要です。

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

# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
// バケットが配置されているAlibaba Cloud リージョンの ID を指定します。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

# ソースイメージがバケットのルートディレクトリに保存されている場合は、イメージ名のみを指定できます。 例: source-example.jpg。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、ソースイメージの完全なパスを指定する必要があります。 例: exampledir/source-example.jpg。
key = 'source-example.jpg'

# 処理済みイメージの保存先の完全なパスを指定します。 例: D:\\target-example.jpg。 同じ名前のイメージがパスに既に存在する場合、処理済みイメージは既存のイメージを上書きします。 それ以外の場合、処理済みイメージはパスに保存されます。
local_file_name = 'D:\\target-example.jpg'

# すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を顔の 2 倍のサイズに拡大します。
process = 'image/blur,g_faces,p_200,r_25,s_50'

# get_object メソッドを使用し、process パラメーターを使用してカスタム切り抜き操作を渡します。
result = bucket.get_object_to_file(key, local_file_name, process=process)

Go

OSS SDK for Go 3.0.2 以降が必要です。

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 インスタンスを作成します。
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 実際のエンドポイントを指定してください。
	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)
	}

	// バケットの名前を指定します。 例: examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージの完全なパスを指定する必要があります。 例: exampledir/example.jpg。
	sourceImageName := "example.jpg"
	// 処理済みイメージの名前を指定します。
	targetImageName := "D://dest.jpg"
	// すべての人間の顔のぼかし半径を 25 に設定し、正規分布の標準偏差を 50 に設定し、ぼかし領域を顔の 2 倍のサイズに拡大します。
	image := "image/blur,p_200,g_faces,r_25,s_50"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

サンプル効果

次の表は、image/blur,g_faces,p_200,r_25,s_50 パラメータを使用して処理されたソースイメージとイメージを示しています。

ソースイメージ

処理済みイメージ

原图

image

参考資料

IMG 操作をイメージの URL に直接追加し、カスケードスタイルシート (CSS) を使用してイメージスタイルを変更し、処理済みイメージの視覚表示を最適化できます。 次のサンプルコードは、IMG 機能を使用してイメージをぼかし、CSS を使用して処理済みイメージの視覚効果を向上させる方法の例を示しています。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>ぼかし効果の例</title>
    <style>
        .blurred {
            filter: blur(5px);
        }

        .container {
            position: relative;
            width: 300px;
        }

        .text {
            position: absolute;
            top: 50%;
            left: 50%;
            transform: translate(-50%, -50%);
            color: white;
            font-size: 24px;
        }
    </style>
</head>
<body>
    <div class="container">
        <img src="https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg" alt="サンプルイメージ" class="blurred">
        <div class="text">Hello World</div>
    </div>
    <div>
        <img src="https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image%2Fblur%2Cr_10%2Cs_10&spm=a2c4g.11186623.0.i12">
    </div>
</body>
</html>