API narzędzi graficznych

Endpointy do kompresji, zmiany rozmiaru, konwersji, rotacji, przycinania, usuwania tła, powiększania, rozmywania twarzy i znakowania wodnego obrazów. Wszystkie endpointy przyjmują multipart/form-data i zwracają przetworzony obraz jako plik binarny.

Kompresja obrazu

POST/api/image-compress

Kompresuj obraz, aby zmniejszyć rozmiar pliku przy zachowaniu jakości wizualnej. Obsługuje formaty JPEG, PNG i WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu (JPG, PNG, WebP)
`quality`	number	Optional	Jakość kompresji, 10-100. Domyślnie: 80
`targetSizeKB`	number	Optional	Docelowy rozmiar pliku w KB. Nadpisuje quality, jeśli ustawiony.
`keepMetadata`	string	Optional	Ustaw na "true", aby zachować metadane 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

Zmiana rozmiaru obrazu

POST/api/image-resize

Zmień rozmiar obrazu do określonych wymiarów lub procentowo. Obsługuje wymiary pikselowe i skalowanie procentowe.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`width`	number	Optional	Docelowa szerokość w pikselach
`height`	number	Optional	Docelowa wysokość w pikselach
`percentage`	number	Optional	Procent skalowania (np. 50 dla połowy rozmiaru)
`fit`	string	Optional	"inside" (zachowaj proporcje) lub "fill" (rozciągnij do dokładnych wymiarów)

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

Konwersja obrazu

POST/api/image-convert

Konwertuj obraz między formatami. Obsługuje PNG, JPG, WebP i AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`format`	string	Required	Format docelowy: "png", "jpg", "webp" lub "avif"
`quality`	number	Optional	Jakość wyjściowa, 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

Rotacja obrazu

POST/api/image-rotate

Obróć i/lub odwróć obraz. Obsługuje dowolne kąty obrotu oraz odbicie poziome/pionowe.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`angle`	number	Required	Kąt obrotu w stopniach (np. 90, 180, 270)
`flipH`	string	Optional	Ustaw na "true", aby odwrócić poziomo
`flipV`	string	Optional	Ustaw na "true", aby odwrócić pionowo

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

Przycinanie obrazu

POST/api/image-crop

Przytnij obraz do określonego prostokątnego obszaru.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`x`	number	Required	Lewe przesunięcie prostokąta przycinania w pikselach
`y`	number	Required	Górne przesunięcie prostokąta przycinania w pikselach
`width`	number	Required	Szerokość prostokąta przycinania w pikselach
`height`	number	Required	Wysokość prostokąta przycinania w pikselach

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

Usuwanie tła

POST/api/remove-bg

Automatycznie usuń tło z obrazu. Zwraca PNG z przezroczystym tłem.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu

Response:Obraz PNG z przezroczystym tłem

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

Powiększanie obrazu

POST/api/image-upscale

Powiększ obraz za pomocą AI, aby zwiększyć rozdzielczość przy zachowaniu szczegółów.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`scale`	number	Optional	Współczynnik powiększenia: 2 lub 4. Domyślnie: 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

Rozmywanie twarzy

POST/api/blur-face

Automatycznie wykryj i rozmyj wszystkie twarze na obrazie w celu ochrony prywatności.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu

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

Znak wodny na obrazie

POST/api/watermark-image

Dodaj tekstowy znak wodny do obrazu. Dostosuj tekst i pozycję.

Parameters

Name	Type	Required	Description
`file`	File	Required	Plik obrazu
`text`	string	Required	Tekst znaku wodnego
`position`	string	Optional	Pozycja: "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