API strumenti immagine

Endpoint per compressione, ridimensionamento, conversione, rotazione, ritaglio, rimozione sfondo, upscaling, sfocatura volti e filigrana delle immagini. Tutti gli endpoint accettano multipart/form-data e restituiscono l'immagine elaborata come file binario.

Comprimi immagine

POST/api/image-compress

Comprimi un'immagine per ridurre la dimensione del file mantenendo la qualita visiva. Supporta i formati JPEG, PNG e WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine (JPG, PNG, WebP)
`quality`	number	Optional	Qualita di compressione, 10-100. Predefinito: 80
`targetSizeKB`	number	Optional	Dimensione file obiettivo in KB. Sovrascrive la qualita se impostato.
`keepMetadata`	string	Optional	Imposta su "true" per preservare i metadati 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

Ridimensiona immagine

POST/api/image-resize

Ridimensiona un'immagine a dimensioni specifiche o per percentuale. Supporta dimensioni in pixel e ridimensionamento percentuale.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`width`	number	Optional	Larghezza obiettivo in pixel
`height`	number	Optional	Altezza obiettivo in pixel
`percentage`	number	Optional	Percentuale di scala (es. 50 per meta dimensione)
`fit`	string	Optional	"inside" (mantieni proporzioni) o "fill" (estendi alle dimensioni esatte)

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

Converti immagine

POST/api/image-convert

Converti un'immagine tra formati. Supporta PNG, JPG, WebP e AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`format`	string	Required	Formato obiettivo: "png", "jpg", "webp" o "avif"
`quality`	number	Optional	Qualita di output, 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

Ruota immagine

POST/api/image-rotate

Ruota e/o capovolgi un'immagine. Supporta angoli di rotazione arbitrari e capovolgimento orizzontale/verticale.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`angle`	number	Required	Angolo di rotazione in gradi (es. 90, 180, 270)
`flipH`	string	Optional	Imposta su "true" per capovolgere orizzontalmente
`flipV`	string	Optional	Imposta su "true" per capovolgere verticalmente

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

Ritaglia immagine

POST/api/image-crop

Ritaglia un'immagine in una regione rettangolare specifica.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`x`	number	Required	Offset sinistro del rettangolo di ritaglio in pixel
`y`	number	Required	Offset superiore del rettangolo di ritaglio in pixel
`width`	number	Required	Larghezza del rettangolo di ritaglio in pixel
`height`	number	Required	Altezza del rettangolo di ritaglio in pixel

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

Rimuovi sfondo

POST/api/remove-bg

Rimuovi automaticamente lo sfondo da un'immagine. Restituisce un PNG con sfondo trasparente.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine

Response:Immagine PNG con sfondo trasparente

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

Upscale immagine

POST/api/image-upscale

Ingrandisci un'immagine usando l'IA per aumentare la risoluzione preservando i dettagli.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`scale`	number	Optional	Fattore di upscale: 2 o 4. Predefinito: 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

Sfoca volto

POST/api/blur-face

Rileva e sfoca automaticamente tutti i volti in un'immagine per la protezione della privacy.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine

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

Filigrana su immagine

POST/api/watermark-image

Aggiungi una filigrana testuale a un'immagine. Personalizza il testo e la posizione.

Parameters

Name	Type	Required	Description
`file`	File	Required	File immagine
`text`	string	Required	Testo della filigrana
`position`	string	Optional	Posizione: "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