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

Object Storage Service:画像処理 (IMG)

最終更新日:Apr 03, 2026

Object Storage Service (OSS) に保存されている画像に対して、GetObject リクエストに画像処理 (IMG) パラメーターを含めることで、画像を処理できます。たとえば、画像にウォーターマークを追加したり、フォーマットを変換したりできます。

IMG パラメーター

OSS 内の画像を 1 つ以上のパラメーターで処理できます。また、複数のパラメーターを画像スタイルとしてまとめて、一括で画像を処理することも可能です。画像スタイルの詳細については、「画像スタイル」をご参照ください。

複数の 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

画像を 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 を使用して画像を処理できます。詳細については、「画像処理メソッド」をご参照ください。

制限事項

項目

説明

画像フォーマット

  • ソース画像は、JPG、PNG、BMP、GIF、WebP、TIFF、HEIC、AVIF のいずれかのフォーマットである必要があります。

  • アニメーション GIF などの動的画像の場合、サイズ変更、クロップ、回転、ウォーターマークのみサポートされています。

  • アニメーション WebP 画像のエンコーディングまたはデコーディングを行うには、チケットを送信してください。

画像サイズ

ソース画像のサイズは 20 MB を超えてはなりません。

ソース画像のディメンション

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

GIF 画像などの動的画像のピクセル総数は width * height * number of frames であり、PNG 画像などの静的画像の場合は width * height です。

ターゲット画像のディメンション

  • WebP 画像の場合、幅および高さは 16,383 px を超えてはなりません。

  • HEIC 画像の場合、幅および高さは 4,096 px を超えてはなりません。

  • AVIF 画像の場合、幅は 4,096 px を超えてはならず、ピクセル総数は 9,437,184 を超えてはなりません。

画像のサイズ変更

サイズ変更後、画像の幅または高さは 16,384 px を超えてはならず、ピクセル総数は 16,777,216 を超えてはなりません。

画像スタイル

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

説明

1 つの画像スタイルに複数の IMG パラメーターを含めることで、複雑な操作を効率的に実行できます。詳細については、「画像スタイル」をご参照ください。

処理能力

  • 秒間画像処理スループット(ソース画像サイズベース)

    • 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (深セン):20 MB/s。

    • その他のリージョン:2 MB/s。

  • 秒間クエリ数 (QPS)

    • 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (深セン):50。

    • その他のリージョン:5。

説明

WebP、AVIF、HEIF 画像の 1080p 解像度を超えるエンコーディングなど、計算負荷の高いシナリオや、ワークロードがこれらの制限を超える場合は、テクニカルサポートに連絡して、ユースケースに応じた具体的な制限を評価してください。

課金

IMG の利用に伴い、以下の料金が発生します。

  • リクエスト料金

    各画像処理操作は 1 回の GetObject リクエストを生成し、リクエストごとの料金が発生します。詳細については、「リクエスト料金」をご参照ください。

  • トラフィック料金

    アウトバウンドトラフィック料金は、処理済み画像のサイズに基づいて計算されます。詳細については、「トラフィック料金」をご参照ください。

IMG バージョン

画像処理 (IMG) サービスには、新旧 2 つの API バージョンがあります。本ドキュメントでは、旧バージョンが更新されなくなったため、新 API バージョンについて説明します。2 つのバージョン間の互換性の詳細については、「IMG の新旧バージョンとその互換性」をご参照ください。