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

Object Storage Service:画像処理

最終更新日:Mar 26, 2026

Object Storage Service (OSS) に保存されている画像は、GetObject リクエストに処理パラメーターを追加することで処理できます。たとえば、ウォーターマークの追加やフォーマット変換などの操作を実行できます。

処理パラメーター

OSS に保存されている画像は、1 つ以上のパラメーターを使用して処理したり、複数のパラメーターをイメージスタイルにカプセル化してバッチ処理したりできます。イメージスタイルの詳細については、「イメージスタイル」をご参照ください。

複数の処理パラメーターを指定した場合、OSS は指定された順序で適用します。次の表に、処理パラメーターを示します。

操作

パラメーター

説明

サイズ変更

resize

指定されたディメンションに画像のサイズを変更します。

ウォーターマークの追加

watermark

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

カスタムクロップ

crop

指定されたディメンションの長方形に画像をクロップします。

品質調整

quality

JPG および WebP フォーマットの画像の品質を調整します。

フォーマット変換

format

画像フォーマットを変換します。

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

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

制限事項

パラメーター

説明

画像フォーマット

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

  • GIF などの動的イメージでは、サイズ変更、クロップ、回転、ウォーターマーク追加の操作のみがサポートされます。

  • 動的な WebP イメージのエンコーディングまたはデコーディングを行うには、チケットを送信してこの機能を有効にする必要があります。

画像サイズ

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

画像の幅と高さ

回転操作の場合、ソースイメージの最大幅または高さは 4,096 px です。他のすべての操作では、最大値は 30,000 px で、総ピクセル数は 2 億 5000 万を超えることはできません。

GIF イメージなどの動的イメージの総ピクセル数は、幅 * 高さ * フレーム数 として計算されます。PNG イメージなどの静的イメージの総ピクセル数は、幅 * 高さ として計算されます。

説明

画像を 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 つのイメージスタイルに複数の処理パラメーターを含めることで、複雑な画像変換を実行できます。詳細については、「イメージスタイル」をご参照ください。

処理能力

  • スループット (ソースイメージサイズによる)

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

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

  • 秒間クエリ数 (QPS)

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

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

説明

1080p を超える解像度での WebP、AVIF、または HEIF イメージのエンコーディングなど、計算負荷の高いシナリオの場合、またはこれらの制限を超える必要がある場合は、テクニカルサポートに連絡して、特定の利用要件を評価してください。

課金

Image Processing (IMG) サービスには、以下の料金が適用されます:

  • リクエスト料金

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

  • トラフィック料金

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

バージョン

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