Object Storage Service (OSS) に保存されている画像は、GetObject リクエストに処理パラメーターを追加することで処理できます。たとえば、ウォーターマークの追加やフォーマット変換などの操作を実行できます。
処理パラメーター
OSS に保存されている画像は、1 つ以上のパラメーターを使用して処理したり、複数のパラメーターをイメージスタイルにカプセル化してバッチ処理したりできます。イメージスタイルの詳細については、「イメージスタイル」をご参照ください。
複数の処理パラメーターを指定した場合、OSS は指定された順序で適用します。次の表に、処理パラメーターを示します。
|
操作 |
パラメーター |
説明 |
|
resize |
指定されたディメンションに画像のサイズを変更します。 |
|
|
watermark |
画像に画像またはテキストのウォーターマークを追加します。 |
|
|
crop |
指定されたディメンションの長方形に画像をクロップします。 |
|
|
quality |
JPG および WebP フォーマットの画像の品質を調整します。 |
|
|
format |
画像フォーマットを変換します。 |
|
|
format |
画像を HEIF または AVIF フォーマットに変換します。これらのフォーマットは高い圧縮率を提供します。 |
|
|
info |
基本情報や 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 となります。Alibaba Cloud CDN が back-to-origin 中にソースイメージまたは処理済みイメージのどちらを取得するかについて、異なるルールを設定できます。
-
ソースイメージのフェッチ
Alibaba Cloud CDN でパラメータフィルタリングを有効にすると、ファイル URL リクエストから疑問符 (?) 以降のすべてのパラメーターが削除され、リクエストは直接ソースイメージ
example.jpgにヒットします。 -
処理済みイメージのフェッチ
Alibaba Cloud CDN でパラメーター保持を有効にすると、リクエスト URL 内の疑問符 (?) 以降のすべてのパラメーターが保持されます。これにより、back-to-origin リクエストは処理済みのイメージをフェッチします。
Alibaba Cloud CDN の back-to-origin ルールの設定方法の詳細については、「パラメータの無視」をご参照ください。
画像処理メソッド
画像は、オブジェクト URL、API オペレーション、または SDK を使用して処理できます。詳細については、「画像処理メソッド」をご参照ください。
制限事項
|
パラメーター |
説明 |
|
画像フォーマット |
|
|
画像サイズ |
ソースイメージのサイズは 20 MB を超えることはできません。 |
|
画像の幅と高さ |
回転操作の場合、ソースイメージの最大幅または高さは 4,096 px です。他のすべての操作では、最大値は 30,000 px で、総ピクセル数は 2 億 5000 万を超えることはできません。 GIF イメージなどの動的イメージの総ピクセル数は、 説明
画像を WebP フォーマットに変換する場合、ソースイメージの幅と高さの両方が 16,383 px を超えてはなりません。超えた場合、変換は失敗します。 |
|
画像圧縮 |
サイズ変更後、出力イメージの幅または高さは 16,384 px を超えることはできず、総ピクセル数は 16,777,216 を超えることはできません。 |
|
高度な画像圧縮 |
サイズ変更後、HEIC イメージのディメンションは 4,096 × 4,096 px を、AVIF イメージのディメンションは 4,096 × 2,304 px を超えることはできません。 |
|
イメージスタイル |
1 つのバケットあたり最大 50 個のイメージスタイルを作成できます。ビジネスでさらに多くのスタイルが必要な場合は、チケットを送信してください。 説明
1 つのイメージスタイルに複数の処理パラメーターを含めることで、複雑な画像変換を実行できます。詳細については、「イメージスタイル」をご参照ください。 |
|
処理能力 |
説明
1080p を超える解像度での WebP、AVIF、または HEIF イメージのエンコーディングなど、計算負荷の高いシナリオの場合、またはこれらの制限を超える必要がある場合は、テクニカルサポートに連絡して、特定の利用要件を評価してください。 |
課金
バージョン
Image Processing (IMG) は 2 つの API バージョンを提供しています。このトピックでは、新しい API バージョンについて説明します。古い API バージョンは更新されなくなりました。2 つのバージョンの互換性の詳細については、「IMG の旧バージョンと新バージョンの違い」をご参照ください。