API инструментов для изображений

Эндпоинты для сжатия, изменения размера, конвертации, поворота, обрезки, удаления фона, увеличения, размытия лиц и добавления водяных знаков. Все эндпоинты принимают multipart/form-data и возвращают обработанное изображение в виде бинарного файла.

Сжатие изображения

POST/api/image-compress

Сожмите изображение для уменьшения размера файла с сохранением визуального качества. Поддерживает форматы JPEG, PNG и WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения (JPG, PNG, WebP)
`quality`	number	Optional	Качество сжатия, 10-100. По умолчанию: 80
`targetSizeKB`	number	Optional	Целевой размер файла в КБ. Переопределяет качество при установке.
`keepMetadata`	string	Optional	Установите "true" для сохранения метаданных EXIF

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-compress \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "quality=75" \
  -o compressed.jpg

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

POST/api/image-resize

Измените размер изображения до определенных размеров или в процентах. Поддерживает размеры в пикселях и процентное масштабирование.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`width`	number	Optional	Целевая ширина в пикселях
`height`	number	Optional	Целевая высота в пикселях
`percentage`	number	Optional	Процент масштабирования (например, 50 для половины размера)
`fit`	string	Optional	"inside" (сохранить пропорции) или "fill" (растянуть до точных размеров)

Response:Binary file

bash

# Resize to specific width (height auto-calculated)
curl -X POST https://freefiletools.io/api/image-resize \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "width=800" \
  -o resized.jpg

# Resize by percentage
curl -X POST https://freefiletools.io/api/image-resize \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "percentage=50" \
  -o resized.jpg

Конвертация изображения

POST/api/image-convert

Конвертируйте изображение между форматами. Поддерживает PNG, JPG, WebP и AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`format`	string	Required	Целевой формат: "png", "jpg", "webp" или "avif"
`quality`	number	Optional	Качество вывода, 10-100

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-convert \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "format=webp" \
  -F "quality=85" \
  -o photo.webp

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

POST/api/image-rotate

Поверните и/или отразите изображение. Поддерживает произвольные углы поворота и горизонтальное/вертикальное отражение.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`angle`	number	Required	Угол поворота в градусах (например, 90, 180, 270)
`flipH`	string	Optional	Установите "true" для горизонтального отражения
`flipV`	string	Optional	Установите "true" для вертикального отражения

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-rotate \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "angle=90" \
  -o rotated.jpg

Обрезка изображения

POST/api/image-crop

Обрежьте изображение до определенной прямоугольной области.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`x`	number	Required	Левый отступ прямоугольника обрезки в пикселях
`y`	number	Required	Верхний отступ прямоугольника обрезки в пикселях
`width`	number	Required	Ширина прямоугольника обрезки в пикселях
`height`	number	Required	Высота прямоугольника обрезки в пикселях

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-crop \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "x=100" \
  -F "y=50" \
  -F "width=500" \
  -F "height=400" \
  -o cropped.jpg

Удаление фона

POST/api/remove-bg

Автоматически удалите фон изображения. Возвращает PNG с прозрачным фоном.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения

Response:PNG-изображение с прозрачным фоном

bash

curl -X POST https://freefiletools.io/api/remove-bg \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o no-background.png

Увеличение изображения

POST/api/image-upscale

Увеличьте изображение с помощью ИИ для повышения разрешения с сохранением деталей.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`scale`	number	Optional	Коэффициент увеличения: 2 или 4. По умолчанию: 2

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-upscale \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "scale=4" \
  -o upscaled.jpg

Размытие лица

POST/api/blur-face

Автоматически обнаруживайте и размывайте все лица на изображении для защиты конфиденциальности.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/blur-face \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o blurred.jpg

Водяной знак на изображении

POST/api/watermark-image

Добавьте текстовый водяной знак на изображение. Настройте текст и положение.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл изображения
`text`	string	Required	Текст водяного знака
`position`	string	Optional	Положение: "center", "top-left", "top-right", "bottom-left", "bottom-right"

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/watermark-image \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "text=Copyright 2024" \
  -F "position=bottom-right" \
  -o watermarked.jpg