すべてのプロダクト
Search

このプロダクト

    Object Storage Service:概要

    ドキュメントセンター

    Object Storage Service:概要

    最終更新日:Feb 23, 2024

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

    制限事項

    項目

    説明

    画像フォーマット

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

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

    • 動画像をWebP形式でエンコードまたはデコードする場合は、 チケットを起票してサポートセンターにお問い合わせくださいしてサポートセンターにお問い合わせください。

    画像サイズ

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

    画像の幅と高さ

    回転操作の場合、ソースイメージの高さまたは幅は4,096ピクセルを超えることはできません。 他の操作では、ソースイメージの幅または高さは30,000ピクセルを超えることはできません。また、ソースイメージの合計ピクセル数は250万を超えることはできません。

    GIF画像などの動画像の総画素数は、幅 × 高さ × 画像フレーム数の式に基づいて計算される。 PNG画像のような静止画像の総ピクセル数は、以下の式に基づいて計算される: 幅 × 高さ。

    イメージ圧縮

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

    高度な画像圧縮

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

    画像スタイル

    バケットごとに最大50の画像スタイルを作成できます。 あなたのビジネスがバケットに50以上のスタイルを必要とする場合、 チケットを起票してサポートセンターにお問い合わせくださいしてサポートセンターにお問い合わせください。

    説明

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

    処理能力

    • 1秒あたりの処理スループット (ソースイメージ別)

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

      • 他の領域の画像処理の最大スループットは2メガバイト/秒です。

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

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

      • 他の領域のQPS限界は5である。

    説明

    WebP、AVIF、またはHEIFイメージを1080pを超える解像度でエンコードするなど、計算負荷の高いビジネスアプリケーションでは、上記の制限を超えることができます。 制限を増やすには、 チケットを起票し、サポートセンターにお問い合わせください。

    課金

    IMGを使用すると、次の料金が請求されます。

    • API 呼び出し料金

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

    • トラフィック料金

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

    IMGバージョン

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