online
Главная Контакты

API Генерация изображений

Документация по API для генерации изображений. Простой и быстрый способ получить изображения нужного размера.

Базовый URL

https://sukhovdev.ru/api/image/random/

Параметры запроса

Параметр Тип Обязательный Описание Пример
w integer Да Ширина изображения в пикселях
Максимум: 4096px
800
h integer Да Высота изображения в пикселях
Максимум: 4096px
600
random integer Нет Индекс генерации изображения. Если изображение с таким индексом уже существует, будет возвращено кешированное изображение 1
noimage boolean Нет Генерация заглушки вместо изображения. Принимает значение 1 1

Примеры использования

Базовый запрос

https://sukhovdev.ru/api/image/random/?w=800&h=600&random=1

Генерирует изображение размером 800x600 пикселей с индексом 1

Генерация заглушки

https://sukhovdev.ru/api/image/random/?w=400&h=300&noimage=1

Генерирует заглушку размером 400x300 пикселей

HTML примеры

 <img src="https://sukhovdev.ru/api/image/random/?w=800&h=600&random=1" alt="Random Image" />
<img src="https://sukhovdev.ru/api/image/random/?w=400&h=300&noimage=1" alt="Placeholder" />

Демонстрация

Случайные изображения

Random 1 Random 2 Random 3 Random 4

Заглушки

Placeholder 1 Placeholder 2

Ограничения

Размеры изображений

  • Максимальная ширина: 4096 пикселей
  • Максимальная высота: 4096 пикселей
  • Минимальные размеры: 1x1 пиксель

Важная информация

Изображения кешируются на сервере по параметрам w, h и random. Если вы запросите изображение с теми же параметрами повторно, будет возвращено уже сгенерированное изображение, что обеспечивает быструю загрузку и экономию ресурсов сервера.

Коды ответов

Код Описание
200 Успешный запрос, изображение возвращено
400 Некорректные параметры запроса
500 Внутренняя ошибка сервера