画像のファイルサイズを最適化
🤖/image/optimize は、形式ごとの圧縮ツールで画像のファイルサイズを削減します。

この Robot は、形式ごとの圧縮ツールを使用して、JPEG、PNG、GIF、WebP、SVG 画像のファイルサイズを削減します。形式と設定によって、最適化は可逆圧縮または非可逆圧縮になります。
この Robot により、ストレージと帯域幅のコストを削減できます。また、画像の多い Web ページの読み込み時間を短縮することで、ユーザー体験と収益化を改善します。
🤖/image/resizeと組み合わせることで、サイズ変更と最適化を施した画像を Web サイトやアプリで最大限に活用できます。
JPEG では、デフォルトの priority: "compression-ratio" と preserve_meta_data: true の設定で、jpegtran による可逆圧縮の結果と MozJPEG cjpeg による非可逆圧縮の結果を比較し、有効な結果のうち最小のものを選択します。cjpeg エンコーダーはデフォルトの品質値 75 を使用するため、選択された結果に圧縮アーティファクトが生じる場合があります。すべての JPEG が品質値 75 で再エンコードされるわけではなく、可逆圧縮の結果が選択される場合もあります。
JPEG の品質をさらに劣化させずに最適化するには、 priority: "conversion-speed" を使用します。これにより、jpegoptim が可逆圧縮モードで実行されます。プログレッシブ JPEG への変換自体も可逆で行えます。例:
{
"steps": {
"optimized": {
"robot": "/image/optimize",
"use": ":original",
"priority": "conversion-speed",
"progressive": true,
"preserve_meta_data": true
}
}
}
この設定では、プログレッシブ変換の結果が元の JPEG より大きくなる場合、jpegoptim が元の JPEG を保持することがあるため、プログレッシブ形式の出力は保証されません。AI 動画生成の入力画像など、圧縮アーティファクトの影響を受けやすいワークフローでは、上記の JPEG 可逆圧縮設定を使用するか、元の画像を保持してください。
この Robot は、すべての画像形式を受け付けます。未対応の画像形式は最適化せずにそのまま渡します。JPEG XL( .jxl )画像も、より小さい最適化結果を生成できない場合はそのまま渡します。そのため、この目的で🤖/file/filterのワークフローを設定する必要はありません。
PNG の最適化は、デフォルトでは可逆圧縮です。非可逆圧縮(pngquant)も有効にするには、 lossy: true と preserve_meta_data: false を設定します。この場合、pngquant が最初に実行され、結果が入力より小さければ常にその結果を使用するため、画像によっては色が変化する場合があります。可逆圧縮の最適化ツールは、pngquant でファイルサイズを削減できない場合にのみ実行されます。
デフォルトの priority: "compression-ratio" による PNG の可逆圧縮最適化では optipng を使用します。大きな画像では数十秒かかる場合があります。代わりに oxipng を使用するには、 priority: "conversion-speed" を設定します。oxipng は複数の CPU コアを使用し、圧縮の試行回数も少ないため、通常はより早く完了しますが、ファイルサイズがわずかに大きくなる場合があります。
使用例
アップロードした画像を最適化する例:
{
"steps": {
"optimized": {
"robot": "/image/optimize",
"use": ":original"
}
}
}パラメーター
interpolateboolean | Record<string, boolean>処理設定の各フィールドで Assembly Variables を展開するかどうかを制御します。
デフォルトでは、Robot の処理設定のほとんどのフィールドで Assembly Variables が展開されます。すべての設定フィールドをリテラルテキストとして扱うには、このパラメーターを
falseに設定してください。特定のフィールドだけをリテラルテキストとして扱うには、そのフィールドのパスをfalseに設定してください。デフォルトでリテラルとして扱われる Robot 固有のフィールドで展開を有効にするには、このパラメーターをtrueに設定するか、そのフィールドのパスをtrueに設定してください。pathのようなフィールド名を使用してください。ネストされたオブジェクトには、ffmpeg.vfのようなドット区切りのパスを使用してください。output_metaRecord<string, boolean> | boolean | Array<string>算出に多くの CPU リソースを要するメタデータを指定できます。Assembly の処理速度を維持するため、これらはデフォルトで無効になっています。
画像の場合、このオブジェクトに
"has_transparency": trueを追加すると、画像に透明な部分が含まれるかどうかを抽出できます。"dominant_colors": trueを追加すると、画像から 16 進数のカラーコードの配列を抽出できます。画像の場合、
"blurhash": trueを追加すると、画像のプレースホルダーをコンパクトに表す BlurHash 文字列も抽出できます。画像全体の読み込み中に、ぼかしたプレビューを表示するのに役立ちます。画像の場合、代わりに
"thumbhash": trueを使用すると、base64 エンコードされた ThumbHash をmeta.thumbhashに抽出し、meta.has_alpha(完全に不透明な場合も含め、アルファチャンネルが存在するかどうか)も抽出します。ThumbHash は EXIF の向きを反映したピクセルを表し、アニメーション画像では最初のフレームを使用します。抽出はベストエフォートです。40 メガピクセルを超える画像、非対応の形式、デコードの失敗やデコード処理の上限への到達があった場合、プレースホルダーは生成されません。抽出に成功すると、そのファイルのバイト数の 20% に相当するメタデータ料金が加算されます。無効な場合やハッシュが生成されない場合、ThumbHash の追加料金は発生しません。このオプションは画像を生成する Step に設定してください。たとえば、アップロードされた元画像では
/upload/handle、処理済みの出力では/image/resizeに設定します。/transloadit/storeにのみ設定しても、抽出は要求されません。ストレージは生成元のメタデータを保持します。Transloadit Storage は生成されたハッシュをその不変のバージョンとともに永続化し、保存済みの結果やネイティブのアセット読み取り時に返します。S3 への直接アップロードではプレースホルダーは生成されません。プレースホルダーには画像情報が含まれるため、画像全体と同じアクセス制御で保護してください。動画の場合、
"colorspace": trueパラメーターを追加すると、出力動画の色空間を抽出できます。動画の場合、
"interlaced": trueを追加すると、インターレース動画かどうかも検出できます。これは、低コストの ffprobe のfield_orderフラグと、ソースの先頭フレームに対する処理範囲を制限したidetサンプリング処理を組み合わせ、file.metaの下にinterlaced、field_order、診断用のinterlace_detectionオブジェクトを出力します。この処理は計算コストが高く、それに応じて課金されます。音声の場合、
"mean_volume": trueを追加すると、音声ファイルの平均音量を表す単一の値を取得できます。また、
falseに設定すると、メタデータの抽出をスキップしてトランスコードを高速化できます。user_metaRecord<string, any>(デフォルト:{})出力される各ファイルに、ファイルの内容を変更せずにカスタム JSON メタデータを追加します。ネストしたオブジェクトと配列に対応しています。
継承の動作は Robot によって異なります。値は出力ファイルの既存の
user_metaとマージされ、一致するトップレベルのキーは現在の Step によって置き換えられます。Robot が新しい出力を作成する場合は、必要なキーを明示的に割り当ててください。処理 Step では、
${file.*}は最初の入力を、${result.*}は出力されるファイルを参照します。値は Robot の実行後、後続のメタデータ抽出と一時保存の前に、出力ごとに評価されます。:originalでは、メタデータ抽出の前にアップロードごとに値が評価されます。後続の Step は
${file.user_meta.key}を読み取ります。完全な例と継承ルールについては、カスタムメタデータ を参照してください。resultboolean(デフォルト:false)この Step の結果を Assembly Status JSON に含めるかどうか
queuebatchqueue を 'batch' に設定すると、このステップのジョブの優先度を手動で下げ、キューの待ち時間がゼロである必要のないジョブが優先ジョブスロットを消費しないようにします。
force_acceptboolean(デフォルト:false)通常は無視するファイルタイプを Robot に強制的に受け入れさせます。
デフォルトでは、Robot は認識できないファイルを無視します。たとえば、🤖/video/encodeは入力画像を無視します。
force_acceptパラメーターをtrueに設定すると、Robot に渡されたすべてのファイルを強制的に受け入れさせることができます。通常、この設定はエラーにつながるため、デバッグやエッジケースへの対処にのみ使用してください。ignore_errorsboolean | Array<meta | execute>(デフォルト:[])処理の特定のフェーズでエラーを無視します。
このパラメーターを
["meta"]に設定すると、Robot はメタデータ抽出中のエラーを無視します。このパラメーターを
["execute"]に設定すると、Robot はメイン実行フェーズ中のエラーを無視します。このパラメーターを
trueに設定すると、["meta", "execute"]と同じ動作になり、両方のフェーズでエラーを無視します。usestring | Array<string> | Array<object> | object入力として使用する Step を指定します。
- Step には任意の名前を付けられます。ただし、
":original"は Transloadit が処理するユーザーアップロード用に予約されています。 - 配列を使用して、複数の Step を入力として指定できます。
{ "use": [ ":original", "encoded", "resized" ] } - 入力 Step に
asでタグを付けて、意味上の用途を Robot に伝えることもできます。{ "use": [ { "name": ":original", "as": "image" }, { "name": ":original", "as": "mask" } ] }
ヒントuseについては、通常ここまでの内容で十分ですが、高度な使用例 も参照できます。- Step には任意の名前を付けられます。ただし、
prioritycompression-ratio | conversion-speed(デフォルト:"compression-ratio")JPEG と PNG の最適化に使用するツールを選択します。デフォルトの
"compression-ratio"は、ファイルサイズの縮小を優先します。JPEG では、preserve_meta_data: trueの場合、品質設定 75 で非可逆の再エンコードを行うことがあり、PNG では optipng を使用します。jpegoptim による JPEG の可逆最適化と、oxipng によるより高速な PNG の可逆最適化には、"conversion-speed"を使用してください。このパラメーターは、GIF、WebP、SVG 画像に使用するツールには影響しません。progressiveboolean(デフォルト:false)trueに設定すると、選択したツールにプログレッシブまたはインターレース形式の出力を要求します。これにより、ブラウザーは最初に粗い画像を表示し、データの受信に応じて詳細を表示できます。JPEG では、プログレッシブ変換自体に品質の低下は必要ありません。非可逆の再エンコードを許可するかどうかは、priorityの設定で決まります。priority: "conversion-speed"の場合、プログレッシブ変換によってファイルサイズが増加するなら、jpegoptim は元の JPEG を保持することがあります。preserve_meta_databoolean(デフォルト:true)最適化時に画像のメタデータを保持するかどうかを指定します。保持しない場合、ファイルサイズをさらに削減できます。ただし、撮影者の著作権情報が削除される可能性があり、当然ながら望ましくないと受け取られかねない点に注意してください。
fix_breaking_imagesboolean(デフォルト:true)trueに設定すると、このパラメーターは、基盤となるツールでエラーを引き起こし、Assembly を失敗させる画像の修復を試みます。ただし、その結果、ファイルサイズが大きくなる場合があります。lossyboolean(デフォルト:false)false(デフォルト)に設定すると、PNG の可逆圧縮最適化ツールのみを使用します。色の正確さを維持するため、pngquant は無効になります。trueに設定すると、pngquant が最初に実行され、結果が入力より小さければ常にその結果を使用します。priorityで選択した可逆圧縮の最適化ツールは、pngquant でファイルサイズを削減できない場合にのみ実行されます。pngquant はメタデータを保持できないため、preserve_meta_dataがfalseの場合にのみ実行されます。pngquant は PNG を 256 色のパレットに減色する非可逆圧縮ツールです。豊富なカラーパレット、微妙なグラデーション、ブランド固有の色を使用する画像では、目立つ色の変化が生じる場合があります。補足このパラメーターは PNG の最適化にのみ影響します。
lossy: falseを設定しても、JPEG の非可逆再エンコードは無効になりません。JPEG の可逆圧縮最適化にはpriority: "conversion-speed"を使用してください。GIF、WebP、SVG の最適化には影響しません。