GetObject リクエストで画像処理 (IMG) パラメーターを指定して、Object Storage Service (OSS) 内の画像オブジェクトを処理できます。たとえば、画像に画像ウォーターマークを追加したり、画像フォーマットを変換したりできます。
IMG パラメーター
OSS では、1 つ以上のパラメーターを使用して画像を処理できます。また、複数の IMG パラメーターをスタイルにカプセル化し、そのスタイルを使用して画像を処理することもできます。画像スタイルの詳細については、「画像スタイル」をご参照ください。
複数の IMG パラメーターを指定した場合、OSS は指定された順序でパラメーターに基づいて画像を処理します。次の表に、IMG パラメーターを示します。
操作 | パラメーター | 説明 |
resize | 画像のサイズを変更します。 | |
watermark | 画像に画像ウォーターマークまたはテキストウォーターマークを追加します。 | |
crop | 指定されたサイズに基づいて長方形の画像をトリミングします。 | |
quality | JPG 形式および WebP 形式の画像の画質を調整します。 | |
format | 画像のフォーマットを指定されたフォーマットに変換します。 | |
format | 高い圧縮効率を提供する HEIF または AVIF に画像フォーマットを変換します。 | |
info | 基本情報と Exchangeable Image File Format (EXIF) 情報を含む画像情報を取得します。 | |
auto-orient | 画像を自動回転します。 | |
circle | 画像の中心点に基づいて、画像を指定されたサイズの円にトリミングします。 | |
indexcrop | 指定された水平軸または垂直軸に沿って画像をトリミングし、画像の 1 つを選択します。 | |
rounded-corners | 指定された角丸半径に基づいて、画像を角丸長方形にトリミングします。 | |
blur | 画像をぼかします。 | |
rotate | 画像を指定された角度だけ時計回りに回転します。 | |
interlace | JPG 画像のプログレッシブ表示を設定します。 | |
average-hue | 画像のドミナントカラーを照会します。 | |
bright | 画像の明るさを調整します。 | |
sharpen | 画像をシャープにします。 | |
contrast | 画像のコントラストを調整します。 |
たとえば、resize
パラメーターと quality
パラメーターを追加して example.jpg
画像を処理する場合、画像の URL は https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300/quality,q_90
です。Alibaba Cloud CDN のオリジン復帰ルールを設定して、取得する画像の URL に含まれる IMG パラメーターを除外または保持できます。このようにして、ソース画像または IMG パラメーターを使用して処理された画像を取得できます。
ソース画像を取得する
Alibaba Cloud CDN のパラメーターフィルタリング機能を有効にして、取得する画像の URL の疑問符 (?) の後に続くすべてのパラメーターを除外できます。この例では、
example.jpg
ソース画像が取得されます。処理済み画像を取得する
Alibaba Cloud CDN のパラメーター保持機能を有効にして、取得する画像の URL の疑問符 (?) の後に続くすべてのパラメーターを保持できます。この例では、処理済み画像が取得されます。
Alibaba Cloud CDN オリジン復帰ルールの詳細については、「パラメーターを無視する」をご参照ください。
IMG メソッド
オブジェクト URL、API 操作、および SDK を使用して画像を処理できます。詳細については、「IMG 実装モード」をご参照ください。
制限
項目 | 説明 |
画像フォーマット |
|
画像サイズ | ソース画像のサイズは 20 MB を超えることはできません。 |
画像の幅と高さ | 回転操作の場合、ソース画像の高さまたは幅は 4,096 ピクセルを超えることはできません。その他の操作の場合、ソース画像の幅または高さは 30,000 ピクセルを超えることはできず、ソース画像のピクセル総数は 2 億 5,000 万を超えることはできません。 GIF 画像などの動的画像のピクセル総数は、 |
画像圧縮 | 圧縮画像の幅または高さは 16,384 ピクセルを超えることはできません。圧縮画像のピクセル総数は 16,777,216 を超えることはできません。 |
高度な画像圧縮 | 圧縮された HEIC 画像のピクセル数は 4,096 × 4,096 を超えることはできません。圧縮された AVIF 画像のピクセル数は 4,096 × 2,304 を超えることはできません。 |
画像スタイル | バケットごとに最大 50 個の画像スタイルを作成できます。ビジネスでバケットに 50 を超えるスタイルが必要な場合は、チケットを送信 してください。 説明 画像スタイルに複数の IMG パラメーターを含めて、バケットに保存されている画像に対して複雑な操作を実行できます。詳細については、「画像スタイル」をご参照ください。 |
処理能力 |
説明 1080p を超える解像度で WebP、AVIF、または HEIF 画像をエンコードするなど、計算量の多いビジネス アプリケーションでは、上記の制限を超える必要がある場合があります。制限を引き上げるには、テクニカルサポート にお問い合わせください。 |
課金
IMG バージョン
IMG は 2 つのバージョンの API 操作を提供します。このトピックでは、新しいバージョンの API 操作について説明します。古いバージョンは更新サポートが提供されなくなりました。新旧バージョンの API 操作の互換性の詳細については、「IMG の新旧バージョンの違い」をご参照ください。