すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:画像処理

最終更新日:Mar 06, 2025

GetObject リクエストで画像処理 (IMG) パラメーターを指定して、Object Storage Service (OSS) 内の画像オブジェクトを処理できます。たとえば、画像に画像ウォーターマークを追加したり、画像フォーマットを変換したりできます。

IMG パラメーター

OSS では、1 つ以上のパラメーターを使用して画像を処理できます。また、複数の IMG パラメーターをスタイルにカプセル化し、そのスタイルを使用して画像を処理することもできます。画像スタイルの詳細については、「画像スタイル」をご参照ください。

複数の IMG パラメーターを指定した場合、OSS は指定された順序でパラメーターに基づいて画像を処理します。次の表に、IMG パラメーターを示します。

操作

パラメーター

説明

サイズ変更

resize

画像のサイズを変更します。

ウォーターマーク

watermark

画像に画像ウォーターマークまたはテキストウォーターマークを追加します。

カスタムトリミング

crop

指定されたサイズに基づいて長方形の画像をトリミングします。

画質調整

quality

JPG 形式および WebP 形式の画像の画質を調整します。

フォーマット変換

format

画像のフォーマットを指定されたフォーマットに変換します。

HEIF または AVIF 画像の高度な圧縮

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 実装モード」をご参照ください。

制限

項目

説明

画像フォーマット

  • JPG、PNG、BMP、GIF、WebP、TIFF、HEIC、および AVIF 画像のみがサポートされています。

  • GIF 画像などの動的画像では、サイズ変更、トリミング、回転、およびウォーターマークのみがサポートされています。

  • WebP 形式で動的画像をエンコードまたはデコードする場合は、チケットを送信 してください。

画像サイズ

ソース画像のサイズは 20 MB を超えることはできません。

画像の幅と高さ

回転操作の場合、ソース画像の高さまたは幅は 4,096 ピクセルを超えることはできません。その他の操作の場合、ソース画像の幅または高さは 30,000 ピクセルを超えることはできず、ソース画像のピクセル総数は 2 億 5,000 万を超えることはできません。

GIF 画像などの動的画像のピクセル総数は、幅 × 高さ × 画像フレーム数 の式に基づいて計算されます。PNG 画像などの静止画像のピクセル総数は、幅 × 高さ の式に基づいて計算されます。

画像圧縮

圧縮画像の幅または高さは 16,384 ピクセルを超えることはできません。圧縮画像のピクセル総数は 16,777,216 を超えることはできません。

高度な画像圧縮

圧縮された HEIC 画像のピクセル数は 4,096 × 4,096 を超えることはできません。圧縮された AVIF 画像のピクセル数は 4,096 × 2,304 を超えることはできません。

画像スタイル

バケットごとに最大 50 個の画像スタイルを作成できます。ビジネスでバケットに 50 を超えるスタイルが必要な場合は、チケットを送信 してください。

説明

画像スタイルに複数の IMG パラメーターを含めて、バケットに保存されている画像に対して複雑な操作を実行できます。詳細については、「画像スタイル」をご参照ください。

処理能力

  • 1 秒あたりの処理スループット (ソース画像ごと)

    • 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (深セン) の各リージョンでは、画像処理の最大スループットは 20 MB/秒です。

    • その他のリージョンの画像処理の最大スループットは 2 MB/秒です。

  • 1 秒あたりのクエリ数 (QPS)

    • 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (深セン) の QPS 制限は 50 です。

    • その他のリージョンの QPS 制限は 5 です。

説明

1080p を超える解像度で WebP、AVIF、または HEIF 画像をエンコードするなど、計算量の多いビジネス アプリケーションでは、上記の制限を超える必要がある場合があります。制限を引き上げるには、テクニカルサポート にお問い合わせください。

課金

IMG を使用すると、次の料金が発生します。

  • API 操作呼び出し費用

    IMG を使用して画像を処理するたびに、GetObject リクエストが生成されます。生成されたリクエストの数に基づいて課金されます。詳細については、「リクエスト費用」をご参照ください。

  • トラフィック費用

    処理済み画像のサイズに基づいて、インターネット経由のアウトバウンドトラフィックに対して課金されます。詳細については、「トラフィック費用」をご参照ください。

IMG バージョン

IMG は 2 つのバージョンの API 操作を提供します。このトピックでは、新しいバージョンの API 操作について説明します。古いバージョンは更新サポートが提供されなくなりました。新旧バージョンの API 操作の互換性の詳細については、「IMG の新旧バージョンの違い」をご参照ください。