Cloudflare Imagesの容量上限を操作別に確認する

保存は10 MB、リモート変換は100 MB、binding入力は20 MB

Imagesに画像をホストするためのアップロードでは、画像ファイルの最大サイズは10 MBです。Imagesへ保存する操作には、この上限を使います。

リモート画像を変換する場合、入力ファイルの最大サイズは100 MBです。ただし、ファイルサイズとは別に画素数・寸法・アニメーションの条件があります。

Workers Images bindingの.input(stream)へ渡す画像データの上限は20 MBです。取得元を問わないため、外部から取得した画像でも、.input(stream)へ渡すなら20 MBの上限で判断します。

リモート変換は形式別の寸法とアニメーションも確認する

リモート画像の面積上限は100 MPですが、アニメーションGIFはこの面積条件の対象外です。寸法の上限は12,000 pxで、WebPとAVIFにはこの数値を適用しません。AVIFの寸法上限は1,200 pxです。

アニメーションGIFとアニメーションWebPには、全フレームの面積の合計に100 MPの上限があります。一方、その合計が50 MPを超えるアニメーションは変換されずに配信されます。合計が100 MP以内でも、50 MPを超えるアニメーションを変換できるとは判断しないでください。

使う操作を決めて入力画像の条件を照合する

まず、Imagesへの保存、リモート画像の変換、Workers Images bindingへの入力のどれを行うか決め、実際に渡す画像のサイズを対応する上限と照合してください。リモート変換では画像形式、画素数、縦横の寸法を調べ、アニメーションなら全フレームの合計面積も確認します。数値条件を満たすことだけで、処理の成功が保証されるわけではありません。

R2やStreamの上限を、Imagesの上限として転用することはできません。R2への保存も検討する場合は、関連する記事でR2のアップロード条件を確認し、Imagesへ渡す操作の条件とは分けて判断してください。