imgix APIs
レンダリング API
自動

自動

auto

オリジナル:185kB
sandbox-demo
auto=compress:35kB
sandbox-demo

autoパラメーターは、画像カタログ全体にわたるベースラインレベルの最適化を自動化するのに役立ちます。現在、次の四つの異なる方法があります:

  • 圧縮
  • 視覚的な向上
  • ファイル形式の変換
  • 赤目除去

必要に応じて、autoが表す設定を画像ごとに上書きするか、コード内で上書きすることができます。たとえば、auto=compressはカラープロファイルのメタデータを削除しますが、サイトに必要な場合は、画像URLにcs=srgbcs=stripなどの異なる値を追加することができます。

注意: auto=formatは有料のお客様向けのデフォルトパラメーターです。無料プランのお客様は、auto=formatをデフォルトパラメーターとして追加しようとすると、アカウントのアップグレードを促されます。

autoの値は、コンマ区切りで組み合わせることができます。また、再反復によって組み合わせる唯一のパラメーターです。たとえば、auto=compress,enhanceのように組み合わせることができます。さらに、auto=compress&auto=enhance&auto=formatのように再反復で組み合わせることもできます。

auto=compress

auto=compressが設定されている場合、imgixは画像のサイズを削減するための最善の努力をします。これには、通常の処理アルゴリズムを変更してより積極的な画像圧縮を適用することが含まれます。

クエリにauto=formatが含まれている場合、それは尊重されます。この場合、画像はできる限りAVIF形式で提供され、圧縮が適用されます。AVIFがサポートされていない場合、画像はWebPとして提供されます。WebP形式がサポートされていない場合、透過を含む画像はPNG8形式で提供され(サポートされている場合)、それ以外の画像はJPEGで提供されます。品質基準(q)は45に設定されています。

注意: 可視情報をできるだけ維持しながらファイルサイズを削減するよう努めていますので、適用される操作は変更される可能性があります。これは、以下の例で見られるように、高い色域範囲を使用する画像で見えます。cs=srgbを追加することで、色の問題を解決し、カラースペースを追加することができます。また、デフォルトの品質基準は、qパラメーターを使用して上書きすることができます。

オリジナル
auto=compress
オリジナル
auto=compress&cs=srgb

注意: アニメーションのないアセットにfmと併用した場合、auto=compressfmパラメーターをオーバーライドし、アルファチャネルが存在するかどうかに応じてJPEGまたはPNGファイルを使用します。

オリジナル:185kB
sandbox-demo
auto=compress:35kB
sandbox-demo

auto=enhance

auto=enhanceが設定されている場合、画像はハイライト、ミドルトーン、およびシャドウの分布を使用して、赤、緑、青(RGB)のすべてのチャネルにわたって調整されます。全体的に、この調整により、画像はより鮮やかな外観になります。

調整は、個々の画像に異なる影響を与え、編集写真、ストック写真、およびソーシャルメディアアプリケーション向けのユーザー生成コンテンツとよく機能します。

オリジナル
sandbox-demo
auto=enhance
sandbox-demo
オリジナル
sandbox-demo
auto=enhance
sandbox-demo

auto=true

auto=trueが設定されている場合、imgixは追加のパラメーターを適用して自動的にアセットを調整します。まず、imgixはアセットにauto=enhanceを適用します。

さらに、crop=facesが設定されており、auto=trueを適用する場合、imgixは自動的にauto=redeyeを適用します。

auto=format

auto=formatが設定されている場合、imgixは自動コンテンツネゴシエーションと呼ばれるプロセスによって、画像をより良い形式で提供できるかどうかを判断します。これには、ヘッダー、ユーザーエージェント、画像アナリティクスなど、利用可能なさまざまなシグナルが含まれます。この形式が提供され、画像が正しくキャッシュされます。

auto=formatロジックは、可能な限りAVIF形式で画像を提供しようとします。AVIFがサポートされていない場合、画像はWebPとして提供されます。WebP形式がサポートされていない場合、ファイルはJPGまたはPNGとして提供されます。

フォールバックロジックは、auto=compressを追加することや、fmでフォールバック形式を指定することで変更できます。これらを併用する場合、fmauto=compressよりも優先されます。たとえば、auto=format&fm=jpgを指定すると、auto=formatがフォールバックパラメーターとしてのみ機能しますが、auto=compress&fm=jpgauto=formatで設定されたファイルタイプをオーバーライドします。 auto=formatおよび自動コンテンツネゴシエーションについて詳しくは、チュートリアルを読んでください

Firefor 66+ 警告

Firefoxバージョン66以降では、画像がウェブページ上でレンダリングされている場合にのみ、自動コンテンツネゴシエーションが行われます。ブラウザで単一の画像を開く場合は行われません。

Safari WebP レンダリングの警告

iOS 14およびSafari >= 14では、システムフレームワークの問題 (opens in a new tab)により、一部のWebP画像が正しくレンダリングされない場合があります。 このため、影響を受けるSafariバージョンでは、auto=formatはJPEGまたはPNGのいずれかを返します。

Safari 16 AVIF 警告

サファリ16 (opens in a new tab)でのAVIFサポートが発表されましたが、ユーザーはAVIFの変換やアニメーションに問題があると報告しています。そのため、Safariブラウザでの自動的なAVIF検出を無効にしました。これにより、サポートされるSafariブラウザでは、auto=formatは代わりにWebPを返します。

auto=redeye

auto=redeyeが設定されている場合、赤目除去が検出された顔に適用されます。

オリジナル
sandbox-demo
auto=redeye
sandbox-demo

Base64非対応

このパラメーターは、ベース64でエンコードされた値を受け付けません。すべての値は、標準のUTF8、URLエンコードされた文字列として提供する必要があります。