Перейти к содержимому
В личный кабинет

Изображения

Чтобы преобразовать изображение, необходимо сделать запрос к файлу с параметрами. Сервис создаст новый файл, отправит его ответом на запрос и сохранит в ваше хранилище.

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

Пример:

// создать новое изображение с шириной 100px с сохранением пропорций
https://api.defaultuploader.com/v1/image/upload/token/sample.jpg?w=100

width

alias: w

Создает изображение с заданной шириной с правильными пропорциями.

min 0, max 5000
Ширина
w=100
Ширина
w=200
Ширина
w=300

height

alias: h

Создает изображение с заданной высотой с правильными пропорциями.

min 0, max 5000
Пример изображения с параметрами
h=100
Пример изображения с параметрами
h=200
Пример изображения с параметрами
h=300

format

alias: f

Изменяет формат изображения.

Поддерживаемые форматы
JPEG, PNG, WebP, AVIF, TIFF, GIF, SVG, HEIC

auto Скоро

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

quality

alias: q
min 0, max 100 значение по умолчанию = 75

Изменить качество изображения.

Пример изображения с параметрами
q=100
Пример изображения с параметрами
q=1

dpr


1, 2 — по умолчанию 1

Поддержка экранов с высоким разрешением, функция просто увеличивает размер изображения в 2 раза.

Пример изображения с параметрами
w=100&dpr=1
Пример изображения с параметрами
w=100&dpr=2

animated

alias: a
animated=0

Отключить анимацию у giff или webp

Пример изображения с параметрами
animated=0
Пример изображения с параметрами

fit

Как следует изменить размер/обрезать изображение, чтобы оно соответствовало целевому размеру(ам).

cover, contain, fill, inside, outside
Пример изображения с параметрами
h=200&w=500&fit=contain
Пример изображения с параметрами
h=200&w=500&fit=cover
Пример изображения с параметрами
h=200&w=500&fit=fill
Пример изображения с параметрами
h=200&w=500&fit=inside
Пример изображения с параметрами
h=200&w=500&fit=outside

func

Умный кроп. При помощии ИИ находит “интересное” место на изображении или лицо и обрезает его по центру.

face, auto
Пример изображения с параметрами
h=500&w=500&func=face
Пример изображения с параметрами
h=500&w=500

zoom

alias: z

Опциональный параметр для “умного” кропа. Регулирует отступы.

min 0.1, max 1
0.1 - это 10% от стороны изображения
Пример изображения с параметрами
h=600&w=600&func=face&zoom=1
Пример изображения с параметрами
h=600&w=600&func=face&zoom=0.3

blur

Создает размытое изображение

min 0.3, max 1000
Пример изображения с параметрами
blur=10

negate

Создает “негатив” изображение

?negate
Пример изображения с параметрами
negate

normalize_lower

Повысьте контрастность выходного изображения, растянув его яркость для покрытия полного динамического диапазона

min 1, max 99
Пример изображения с параметрами
normalize_lower=65

normalize_upper

Повысьте контрастность выходного изображения, растянув его яркость для покрытия полного динамического диапазона

min 1, max 99
Пример изображения с параметрами
normalize_upper=95

saturation

Установите насыщенность изображения

min 0.1
Пример изображения с параметрами
saturation=0.1
Пример изображения с параметрами
saturation=1.5

brightness

Установите яркость изображения

min 0.1
Пример изображения с параметрами
brightness=0.1
Пример изображения с параметрами
brightness=1.5

hue

Установите яркость изображения

min 1
Пример изображения с параметрами
hue=25

lightness

Установите тон изображения

min 0.1
Пример изображения с параметрами
lightness=30

greyscale

Преобразует изображение, сделав его черно-белым

?greyscale
Пример изображения с параметрами
greyscale

radius

Скругляет края изображения

min 0 max 100
Пример изображения с параметрами
rs=5

Чтобы создать круглое изображение, нужно установить равные стороны

Пример изображения с параметрами
rs=50&w=400&h=400

remove_background

alias: rm_bg

Удаляет фон на изображении

?rm_bg
Пример изображения с параметрами
rm_bg
Пример изображения с параметрами
rm_bg&func=face&z=0.3&rs=50

super_resolution скоро

С помощью ИИ увеличивает разрешение изображения