Goruntu Aracları API

Goruntu sıkıstırma, yeniden boyutlandırma, donusturme, dondurme, kırpma, arka plan kaldırma, buyutme, yuz bulanıklastırma ve filigran ekleme icin uc noktalar. Tum uc noktalar multipart/form-data kabul eder ve islenmis goruntuyü ikili dosya olarak dondurur.

Goruntu Sıkıstırma

POST/api/image-compress

Gorsel kaliteyi koruyarak dosya boyutunu azaltmak icin bir goruntuyü sıkıstırın. JPEG, PNG ve WebP formatlarını destekler.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası (JPG, PNG, WebP)
`quality`	number	Optional	Sıkıstırma kalitesi, 10-100. Varsayılan: 80
`targetSizeKB`	number	Optional	KB cinsinden hedef dosya boyutu. Ayarlanırsa kaliteyi gecersiz kılar.
`keepMetadata`	string	Optional	EXIF meta verilerini korumak icin "true" olarak ayarlayın

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

Goruntu Yeniden Boyutlandırma

POST/api/image-resize

Bir goruntuyü belirli boyutlara veya yuzdeye gore yeniden boyutlandırın. Piksel boyutlarını ve yuzde olceklendirmeyi destekler.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`width`	number	Optional	Piksel cinsinden hedef genislik
`height`	number	Optional	Piksel cinsinden hedef yukseklik
`percentage`	number	Optional	Olcek yuzdesi (ornegin yarı boyut icin 50)
`fit`	string	Optional	"inside" (en-boy oranını koru) veya "fill" (tam boyutlara ger)

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

Goruntu Donusturme

POST/api/image-convert

Bir goruntuyü formatlar arasında donusturun. PNG, JPG, WebP ve AVIF destekler.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`format`	string	Required	Hedef format: "png", "jpg", "webp" veya "avif"
`quality`	number	Optional	Cıkıs kalitesi, 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

Goruntu Dondurme

POST/api/image-rotate

Bir goruntuyü dondurun ve/veya cevirin. Rastgele dondurme acılarını ve yatay/dikey cevirmeyi destekler.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`angle`	number	Required	Derece cinsinden dondurme acısı (ornegin 90, 180, 270)
`flipH`	string	Optional	Yatay cevirmek icin "true" olarak ayarlayın
`flipV`	string	Optional	Dikey cevirmek icin "true" olarak ayarlayın

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

Goruntu Kırpma

POST/api/image-crop

Bir goruntuyü belirli bir dikdortgen bolgeye kırpın.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`x`	number	Required	Kırpma dikdortgeninin piksel cinsinden sol ofseti
`y`	number	Required	Kırpma dikdortgeninin piksel cinsinden ust ofseti
`width`	number	Required	Kırpma dikdortgeninin piksel cinsinden genisligi
`height`	number	Required	Kırpma dikdortgeninin piksel cinsinden yuksekligi

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

Arka Plan Kaldırma

POST/api/remove-bg

Bir goruntunun arka planını otomatik olarak kaldırın. Saydam arka planlı PNG dondurur.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası

Response:Saydam arka planlı PNG goruntu

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

Goruntu Buyutme

POST/api/image-upscale

Ayrıntıyı koruyarak cozunurlugu artırmak icin yapay zeka kullanarak bir goruntuyü buyutun.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`scale`	number	Optional	Buyutme faktoru: 2 veya 4. Varsayılan: 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

Yuz Bulanıklastırma

POST/api/blur-face

Gizlilik koruması icin bir goruntudeki tum yuzleri otomatik olarak tespit edin ve bulanıklastırın.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası

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

Goruntuye Filigran Ekleme

POST/api/watermark-image

Bir goruntuye metin filigranı ekleyin. Metni ve konumu ozellestirin.

Parameters

Name	Type	Required	Description
`file`	File	Required	Goruntu dosyası
`text`	string	Required	Filigran metni
`position`	string	Optional	Konum: "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