GetObjectリクエストでImage Processing (IMG) パラメーターを指定して、Object Storage Service (OSS) でイメージオブジェクトを処理できます。 たとえば、画像透かしを画像に追加したり、画像形式を変換したりできます。
IMGパラメータ
OSSでは、1つ以上のパラメータを使用して画像を処理できます。 複数のIMGパラメータをスタイルにカプセル化し、そのスタイルを使用して画像を処理することもできます。 画像スタイルの詳細については、「画像スタイル」をご参照ください。
複数のIMGパラメータを指定した場合、OSSは指定された順序でパラメータに基づいてイメージを処理します。 次の表に、IMGパラメータを示します。
API 操作 | パラメーター | 説明 |
サイズを変更する | 画像のサイズを変更します。 | |
ウォーターマーク | 画像透かしまたはテキスト透かしを画像に追加します。 | |
crop | 指定したサイズに基づいて長方形の画像を切り取ります。 | |
quality | JPG形式とWebP形式の画像の品質を調整します。 | |
フォーマット | 画像の形式を指定した形式に変換します。 | |
info | 基本情報とEXIF (Exchangeable image File Format) 情報を含む画像情報を取得します。 | |
auto-orient | 画像を自動回転させます。 | |
サークル | 画像の中心点に基づいて、指定したサイズの円に画像を切り取ります。 | |
indexcrop | 指定された水平軸または垂直軸に沿って画像を切り取り、画像の1つを選択します。 | |
丸みを帯びたコーナー | 指定された丸め半径に基づいて、画像を丸めた長方形に切り取ります。 | |
ぼかし | ぼかし画像。 | |
rotate | 画像を指定した角度だけ時計回りに回転させます。 | |
インターレース | JPG画像の段階的な表示を設定します。 | |
平均色相 | 画像の平均色相を照会します。 | |
明るい | 画像の明るさを調整します。 | |
シャープ | 画像をシャープにします。 | |
コントラスト | 画像のコントラストを調整します。 |
たとえば、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 back-to-originルールを設定して、取得するイメージのURLに含まれるIMGパラメーターを除外または保持することができます。 これにより、ソースイメージまたはIMGパラメータを使用して処理されたイメージを取得できます。
ソースイメージを取得する
Alibaba Cloud CDNのパラメータフィルタリング機能を有効にして、取得するイメージのURLの疑問符 (?) に続くすべてのパラメータをフィルタリングできます。 この例では、
example.jpg
ソースイメージが取得されます。処理されたイメージを取得する
Alibaba Cloud CDNのパラメーター保持機能を有効にして、取得するイメージのURLの疑問符 (?) に続くすべてのパラメーターを保持できます。 この例では、処理された画像が取り出される。
Alibaba Cloud CDN back-to-originルールの詳細については、「パラメーターを無視」をご参照ください。
IMGメソッド
オブジェクトURL、API操作、SDKを使用してイメージを処理できます。 詳細については、「IMG実装モード」をご参照ください。
制限事項
項目 | 説明 |
画像フォーマット |
|
画像サイズ | ソースイメージのサイズは20 MBを超えることはできません。 |
画像の幅と高さ | 回転操作の場合、ソースイメージの高さまたは幅は4,096ピクセルを超えることはできません。 他の操作では、ソースイメージの幅または高さは30,000ピクセルを超えることはできません。また、ソースイメージの合計ピクセル数は250万を超えることはできません。 GIF画像などの動画像の総画素数は、 |
イメージ圧縮 | 圧縮画像の幅または高さは16,384ピクセルを超えることはできません。 圧縮画像の総ピクセル数は16,777,216を超えることはできません。 |
高度な画像圧縮 | 圧縮されたHEIC画像のピクセル数は、4,096 × 4,096を超えることはできない。 304、圧縮されたAVIF画像の画素数は、4,096 × 2を超えることはできない。 |
画像スタイル | バケットごとに最大50の画像スタイルを作成できます。 あなたのビジネスがバケットに50以上のスタイルを必要とする場合、 チケットを起票してサポートセンターにお問い合わせくださいしてサポートセンターにお問い合わせください。 説明 イメージスタイルに複数のIMGパラメータを含めると、バケットに保存されているイメージに対して複雑な操作を実行できます。 詳細については、「イメージスタイル」をご参照ください。 |
処理能力 |
説明 WebP、AVIF、またはHEIFイメージを1080pを超える解像度でエンコードするなど、計算負荷の高いビジネスアプリケーションでは、上記の制限を超えることができます。 制限を増やすには、 チケットを起票し、サポートセンターにお問い合わせください。 |
課金
IMGバージョン
IMGは2つのバージョンのAPI操作を提供します。 このトピックでは、新しいバージョンのAPI操作について説明します。 古いバージョンの更新サポートは提供されなくなりました。 新しいバージョンと古いバージョンのAPI操作の互換性の詳細については、「IMGの古いバージョンと新しいバージョンの違い」をご参照ください。