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 に複数のパラメーターを追加できます。
非公開イメージをぼかす
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 が指定されている場合にのみ有効です。 |
例
イメージ全体をぼかす
次のパラメーターを設定します。
パブリック読み取りまたはパブリック読み取り/書き込みイメージの場合、イメージ URL の末尾に ?x-oss-process=image/blur,r_10,s_10
を追加できます。その後、OSS は指定されたパラメータに基づいてイメージをリアルタイムで処理し、処理されたイメージを返します。非公開イメージをぼかす方法の詳細については、「非公開イメージをぼかす」をご参照ください。
サンプル効果
次の例では、ソースイメージの URL の末尾に ?x-oss-process=image/blur,r_10,s_10
を追加することで、ソースイメージをぼかす方法について説明します。
イメージ内の最大の人間の顔をぼかす
次のパラメーターを設定します。
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
パラメータを使用して処理されたソースイメージとイメージを示しています。
ソースイメージ | 処理済みイメージ |

| 
|
イメージ内のすべての人間の顔をぼかす
次のパラメーターを設定します。
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
パラメータを使用して処理されたソースイメージとイメージを示しています。
ソースイメージ | 処理済みイメージ |

| 
|
イメージ内の最大の人間の顔をぼかし、ぼかし領域を最大の顔の 2 倍のサイズに拡大する
次のパラメーターを設定します。
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
パラメータを使用して処理されたソースイメージとイメージを示しています。
ソースイメージ | 処理済みイメージ |

| 
|
イメージ内のすべての人間の顔をぼかし、ぼかし領域を顔の 2 倍のサイズに拡大する
次のパラメーターを設定します。
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
パラメータを使用して処理されたソースイメージとイメージを示しています。
ソースイメージ | 処理済みイメージ |

| 
|
参考資料
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>