Object Storage Service (OSS) に保存されている画像に対して、GetObject リクエストに画像処理 (IMG) パラメーターを含めることで、画像を処理できます。たとえば、画像にウォーターマークを追加したり、フォーマットを変換したりできます。
IMG パラメーター
OSS 内の画像を 1 つ以上のパラメーターで処理できます。また、複数のパラメーターを画像スタイルとしてまとめて、一括で画像を処理することも可能です。画像スタイルの詳細については、「画像スタイル」をご参照ください。
複数の IMG パラメーターを指定する場合、OSS は指定された順序で画像を処理します。次の表に、IMG パラメーターを示します。
操作 | パラメーター | 説明 |
resize | 画像を指定されたディメンションにサイズ変更します。 | |
watermark | 画像またはテキストのウォーターマークを画像に追加します。 | |
crop | 画像を指定されたサイズの長方形にクロップします。 | |
quality | JPG および WebP 画像の品質を調整します。 | |
format | 画像のフォーマットを変換します。 | |
format | 画像を HEIF や AVIF などの高圧縮フォーマットに変換します。 | |
info | 基本プロパティや Exchangeable Image File Format (EXIF) データなど、画像情報を取得します。 | |
auto-orient | 画像の向きメタデータに基づいて、自動的に画像を回転します。 | |
circle | 元画像の中央を中心として、指定されたサイズの円形画像をクロップします。 | |
indexcrop | 画像を X 軸または Y 軸に沿って複数のセクションにスライスし、そのうち 1 つのスライスを選択します。 | |
rounded-corners | 指定された半径で角が丸くなった長方形に画像をクロップします。 | |
blur | 画像にぼかし効果を適用します。 | |
rotate | 画像を時計回りに指定された角度だけ回転します。 | |
interlace | JPG フォーマットの画像に対してプログレッシブレンダリングを有効化します。 | |
average-hue | 画像のドミナントカラーを取得します。 | |
bright | 画像の輝度を調整します。 | |
sharpen | 画像にシャープ効果を適用します。 | |
contrast | 画像のコントラストを調整します。 |
たとえば、ソース画像 example.jpg に画像のサイズ変更 resize および品質調整 quality パラメーターを追加すると、ファイル 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 になります。CDN のバックトゥオリジンリクエスト時に、ソース画像または処理済み画像のどちらを取得するかを異なるルールで設定できます。
ソース画像へのバックトゥオリジン
CDN でパラメータフィルタリングを有効化すると、ファイル URL リクエスト内の疑問符 (?) 以降のすべてのパラメーターが削除され、リクエストは直接ソース画像
example.jpgにヒットします。処理済み画像へのバックトゥオリジン
CDN でパラメーターを保持するように設定すると、バックトゥオリジンリクエストでは疑問符 (?) 以降のすべてのパラメーターが維持されます。これにより、CDN は処理済み画像をフェッチします。
CDN のバックトゥオリジンルールの設定方法の詳細については、「パラメーターの無視」をご参照ください。
IMG メソッド
オブジェクト URL、API オペレーション、SDK を使用して画像を処理できます。詳細については、「画像処理メソッド」をご参照ください。
制限事項
項目 | 説明 |
画像フォーマット |
|
画像サイズ | ソース画像のサイズは 20 MB を超えてはなりません。 |
ソース画像のディメンション | 回転操作の場合、ソース画像の幅または高さは 4,096 px を超えてはなりません。その他のすべての操作では、幅または高さは 30,000 px を超えてはならず、ピクセル総数は 2 億 5,000 万を超えてはなりません。 GIF 画像などの動的画像のピクセル総数は |
ターゲット画像のディメンション |
|
画像のサイズ変更 | サイズ変更後、画像の幅または高さは 16,384 px を超えてはならず、ピクセル総数は 16,777,216 を超えてはなりません。 |
画像スタイル | 1 つのバケットにつき最大 50 個の画像スタイルを作成できます。ビジネス要件でさらに多くのスタイルが必要な場合は、チケットを送信してください。 説明 1 つの画像スタイルに複数の IMG パラメーターを含めることで、複雑な操作を効率的に実行できます。詳細については、「画像スタイル」をご参照ください。 |
処理能力 |
説明 WebP、AVIF、HEIF 画像の 1080p 解像度を超えるエンコーディングなど、計算負荷の高いシナリオや、ワークロードがこれらの制限を超える場合は、テクニカルサポートに連絡して、ユースケースに応じた具体的な制限を評価してください。 |
課金
IMG バージョン
画像処理 (IMG) サービスには、新旧 2 つの API バージョンがあります。本ドキュメントでは、旧バージョンが更新されなくなったため、新 API バージョンについて説明します。2 つのバージョン間の互換性の詳細については、「IMG の新旧バージョンとその互換性」をご参照ください。