API nastroju pro obrazky

Koncove body pro kompresi obrazku, zmenu velikosti, konverzi, rotaci, orez, odstraneni pozadi, zviseni rozliseni, rozmazani obliceju a vodni znaky. Vsechny koncove body prijimaji multipart/form-data a vraceji zpracovany obrazek jako binarni soubor.

Komprese obrazku

POST/api/image-compress

Komprimujte obrazek pro snizeni velikosti souboru pri zachovani vizualni kvality. Podporuje formaty JPEG, PNG a WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku (JPG, PNG, WebP)
`quality`	number	Optional	Kvalita komprese, 10-100. Vychozi: 80
`targetSizeKB`	number	Optional	Cilova velikost souboru v KB. Prepise kvalitu, pokud je nastavena.
`keepMetadata`	string	Optional	Nastavte na "true" pro zachovani EXIF metadat

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

Zmena velikosti obrazku

POST/api/image-resize

Zmente velikost obrazku na konkretni rozmery nebo o procenta. Podporuje pixelove rozmery a procentualni skalovani.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`width`	number	Optional	Cilova sirka v pixelech
`height`	number	Optional	Cilova vyska v pixelech
`percentage`	number	Optional	Procento skalovani (napr. 50 pro polovicni velikost)
`fit`	string	Optional	"inside" (zachovat pomer stran) nebo "fill" (roztahnout na presne rozmery)

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

Konverze obrazku

POST/api/image-convert

Prevedte obrazek mezi formaty. Podporuje PNG, JPG, WebP a AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`format`	string	Required	Cilovy format: "png", "jpg", "webp" nebo "avif"
`quality`	number	Optional	Kvalita vystupu, 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

Rotace obrazku

POST/api/image-rotate

Otocte a/nebo prevratte obrazek. Podporuje libovolne uhly rotace a horizontalni/vertikalni prevraceni.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`angle`	number	Required	Uhel rotace ve stupnich (napr. 90, 180, 270)
`flipH`	string	Optional	Nastavte na "true" pro horizontalni prevraceni
`flipV`	string	Optional	Nastavte na "true" pro vertikalni prevraceni

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

Orez obrazku

POST/api/image-crop

Oriznte obrazek na konkretni obdelnikovou oblast.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`x`	number	Required	Levy odsazeni oriznuteho obdelniku v pixelech
`y`	number	Required	Horni odsazeni oriznuteho obdelniku v pixelech
`width`	number	Required	Sirka oriznuteho obdelniku v pixelech
`height`	number	Required	Vyska oriznuteho obdelniku v pixelech

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

Odstraneni pozadi

POST/api/remove-bg

Automaticky odstrante pozadi z obrazku. Vraci PNG s pruhlednym pozadim.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku

Response:PNG obrazek s pruhlednym pozadim

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

Zviseni rozliseni obrazku

POST/api/image-upscale

Zvyste rozliseni obrazku pomoci AI pri zachovani detailu.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`scale`	number	Optional	Faktor zviseni: 2 nebo 4. Vychozi: 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

Rozmazani obliceje

POST/api/blur-face

Automaticky detekujte a rozmazte vsechny obliceje na obrazku pro ochranu soukromi.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku

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

Vodni znak obrazku

POST/api/watermark-image

Pridejte textovy vodni znak na obrazek. Prispusobte text a pozici.

Parameters

Name	Type	Required	Description
`file`	File	Required	Soubor obrazku
`text`	string	Required	Text vodniho znaku
`position`	string	Optional	Pozice: "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