Синтаксис URL и реальные ограничения проекта

На странице собраны только рабочие параметры генератора: размеры, форматы, цвета, текст, шрифты и retina-модификаторы.

10-4000 px Текст до 120 символов SVG по умолчанию Retina @2x/@3x

Параметры URL

Краткая шпаргалка по каждому параметру без лишнего текста.

Ширина Обязательный

Ширина изображения в пикселях.

Высота Необязательный

Высота изображения в пикселях.

Формат Необязательный

Формат вывода: svg, png, jpg, jpeg, webp, avif.

Фон Необязательный

Цвет фона в HEX или CSS-имени.

Цвет текста Необязательный

Цвет текста в HEX или CSS-имени.

Текст Необязательный

Текст, который будет показан на изображении.

Шрифт Необязательный

Шрифт: inter, roboto, open-sans, lato, montserrat, arial.

Retina Необязательный

Модификатор @2x или @3x для растровых форматов.

Рабочие примеры

Эти ссылки можно сразу копировать. Кнопка открытия показывается только для примеров, которые реально отработают в текущей среде.

/600x400

Открыть

/600x400/111827/F8FAFC

Открыть

/600x400?text=Привет

Открыть

/1200x630/6366f1/fff?text=Баннер&font=inter

Открыть

/600x400/png/000/fff

Открыть

/600x400@2x.png

Открыть

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

Показываем только те форматы, которые действительно предусмотрены в проекте.

SVG Готов

Векторный формат по умолчанию с четким текстом при любом размере.

SVG доступен без дополнительных расширений.

PNG Готов

Растровый формат с поддержкой прозрачности.

PNG доступен в текущей сборке GD.

JPG Готов

Компактный растровый формат для непрозрачных изображений.

JPG доступен в текущей сборке GD.

WebP Готов

Современный сжатый формат для веба.

WEBP доступен в текущей сборке GD.

AVIF Нет поддержки в GD

Современный формат с высоким уровнем сжатия.

Текущая сборка GD не поддерживает AVIF.

Правила маршрута

Базовые правила, которые помогают быстро собрать корректный URL.

Размер задается первым сегментом: /WIDTHxHEIGHT или /WIDTH.
Формат можно передать как сегмент после размера: /600x400/png, либо через расширение: /600x400.png.
Цвет фона и цвет текста всегда передаются парой: /background/foreground.
Текст и шрифт передаются через query string: ?text=... и &font=....

Размеры

Используйте /WIDTHxHEIGHT или только /WIDTH для квадратного изображения. Диапазон проекта: от 10×10 до 4000×4000 пикселей.

/400

/600x400

/1200x630

Форматы

Формат можно передавать отдельным сегментом после размера или через расширение. Если формат не указан, сервис отдает SVG.

/600x400/png

/600x400.png

/600x400/png/111827/F9FAFB

/600x400/111827/F9FAFB.webp

Цвета

Фон и цвет текста передаются парой. Поддерживаются HEX из 3 или 6 символов, CSS-имена и transparent.

/600x400/000/FFF

/600x400/png/0f172a/f8fafc

/600x400/orange/white

Текст

Текст передается через query string. Если его не указать, сервис сам подставит размер изображения.

/600x400?text=Привет

/600x400?text=Первая%5CnВторая

/1200x630/6366f1/fff?text=Баннер

Шрифты

Поддерживаются lato, roboto, open-sans, montserrat, inter и arial. Неизвестное значение автоматически заменяется на lato.

/600x400?font=inter

/1200x630?text=Карточка&font=montserrat

Retina

Для растровых форматов используйте @2x или @3x перед расширением либо перед сегментами цвета. SVG игнорирует retina-модификаторы.

/600x400@2x.png

/600x400@3x/webp/111827/F8FAFC

Встраивание

Один и тот же URL подходит для HTML, CSS, Markdown и прямых ссылок.

<img src="https://www.image-tools.ru/1200x630/5B67F1/F7F8FF?text=Обложка&font=inter" alt="Обложка">

background-image: url('https://www.image-tools.ru/600x400/111827/F8FAFC?text=Hero');

![заглушка](https://www.image-tools.ru/800x800/5AC983/F5FFF9?text=Аватар)