INTEGRITY Документация

← Images / images / get-started

Ограничения и форматы

В этом разделе описаны ограничения и поддерживаемые форматы для Images.

Лимиты

Вот ограничения, которые нужно учитывать при оптимизации с помощью Images.

На плане Enterprise вы можете обратиться к своей команде по работе с клиентами, чтобы согласовать лимиты с вашими потребностями.

Удалённые изображения

При трансформации удалённого изображения, хранящегося за пределами Images, действуют следующие ограничения:

Attribute Лимит
Размер файла изображения 100 МБ
Площадь изображения, без учёта анимированных GIF 100 МП (например, 10,000x10,000 пикселей)
Площадь изображения для анимированных GIF 100 МП*
Размер изображения, без учёта WebP и AVIF 12,000 пикселей
Размер изображения, AVIF 1,200 пикселей

Размещённые изображения

При загрузке в хранилище Images действуют следующие ограничения:

Attribute Лимит
Размер файла изображения 10 MB
Площадь изображения, без учёта анимированных GIF 100 МП (например, 10,000x10,000 пикселей)
Площадь изображения, анимированные GIF 100 МП*
Размер изображения, без учёта WebP и AVIF 12,000 пикселей
Размер изображения, AVIF 1,200 пикселей
Метаданные изображения 1024 байта

Ограничения для анимированных изображений

Анимации GIF/WebP ограничены суммарным количеством мегапикселей по всем кадрам, то есть суммой площадей всех кадров. Например, GIF размером 500x500 с 10 кадрами имеет площадь изображения 2,500,000 пикселей, или 2.5 мегапикселя.

Ограничение на доставку анимации GIF/WebP составляет 100 мегапикселей. При этом анимации свыше 50 мегапикселей доставляются без применения каких-либо трансформаций.

Для показа анимации рекомендуется использовать видеоформаты, такие как MP4 и WebM: так производительность будет выше. Формат GIF сжимает данные неэффективно, поэтому анимации высокого разрешения в нём обычно получаются более тяжёлыми и дольше сжимаются.

Чтобы оптимизировать удаленные видео, можно использовать преобразования медиафайлов ↗.

Ограничения для привязки Images

При оптимизации с помощью Привязка Images, максимальный размер входных данных для .input() составляет 20 МБ.

Поддерживаемые форматы

Входные форматы

Images поддерживает широкий спектр входных форматов как для удалённых, так и для хостируемых изображений:

*Доступно на плане Enterprise.

Форматы вывода

Изображения можно отдавать в следующих выходных форматах:

При выборе оптимального формата для запрашивающего браузера Cloudflare соотносит время генерации изображения со временем его передачи браузеру.

Кодирование в AVIF может выполняться на порядок медленнее, чем в другие форматы. Если изображение слишком велико для быстрого кодирования в AVIF, Cloudflare переключается на WebP или JPEG.

Прогрессивный JPEG

При перекодировании в JPEG Cloudflare создаёт изображения в чересстрочном прогрессивном формате JPEG.

Вы можете использовать format чтобы задать, использовать ли прогрессивный или базовый JPEG.

Однако мы всегда переходим на базовый формат JPEG (даже если указан прогрессивный JPEG) в следующих случаях:

SVG

Cloudflare не изменяет размер файлов SVG и игнорирует любые параметры оптимизации.

Если вы храните изображения в Images, любой предопределённый вариант можно использовать как заглушку для отдачи очищенного SVG. Например, применение варианта public по умолчанию позволяет отдавать SVG без изменения размера и обрезки:

imagedelivery.net/account_hash/svg_id/public

Аналогично можно использовать Images для отдачи очищенного SVG, который хранится на вашем origin-сервере, как в R2.

При отдаче файлов SVG они очищаются с помощью svg-hush ↗, инструмент с открытым исходным кодом от Cloudflare, разработанный для максимальной безопасности SVG. Он передаёт файлы потоково, без буферизации, что позволяет быстро фильтровать их на лету. Файлы SVG являются XML-документами и могут содержать ссылки или функции JavaScript, которые представляют угрозу безопасности.

svg-hush инструмент фильтрует SVG и удаляет потенциально опасные элементы, такие как: