API iнструментiв зображень

Кiнцевi точки для стиснення зображень, змiни розмiру, конвертацiї, обертання, обрiзки, видалення фону, збiльшення масштабу, розмиття облич та водяних знакiв. Усi кiнцевi точки приймають multipart/form-data та повертають оброблене зображення як бiнарний файл.

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

POST/api/image-compress

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

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл зображення (JPG, PNG, WebP)
`quality`	number	Optional	Якiсть стиснення, 10-100. За замовчуванням: 80
`targetSizeKB`	number	Optional	Цiльовий розмiр файлу в КБ. Перевизначає якiсть, якщо встановлено.
`keepMetadata`	string	Optional	Встановiть "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

Змiна розмiру зображення

POST/api/image-resize

Змiнiть розмiр зображення до конкретних розмiрiв або у вiдсотках. Пiдтримує розмiри в пiкселях та вiдсоткове масштабування.

Parameters

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

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

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

POST/api/image-convert

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

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл зображення
`format`	string	Required	Цiльовий формат: "png", "jpg", "webp" або "avif"
`quality`	number	Optional	Якiсть виведення, 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

Обернiть та/або вiддзеркалiть зображення. Пiдтримує довiльнi кути обертання та горизонтальне/вертикальне вiддзеркалення.

Parameters

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

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

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

POST/api/image-crop

Обрiжте зображення до конкретної прямокутної областi.

Parameters

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

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

Автоматично видалiть фон iз зображення. Повертає 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

Збiльшення масштабу зображення

POST/api/image-upscale

Збiльшiть роздiльнiсть зображення за допомогою AI зi збереженням деталей.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл зображення
`scale`	number	Optional	Коефiцiєнт збiльшення: 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

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

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

Додайте текстовий водяний знак на зображення. Налаштуйте текст та позицiю.

Parameters

Name	Type	Required	Description
`file`	File	Required	Файл зображення
`text`	string	Required	Текст водяного знаку
`position`	string	Optional	Позицiя: "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