API Instrumente pentru imagini

Puncte finale pentru compresie imagini, redimensionare, conversie, rotire, decupare, eliminare fundal, marire rezolutie, estompare fete si filigran. Toate punctele finale accepta multipart/form-data si returneaza imaginea procesata ca fisier binar.

Compresie imagine

POST/api/image-compress

Comprima o imagine pentru a reduce dimensiunea fisierului mentinand calitatea vizuala. Suporta formatele JPEG, PNG si WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine (JPG, PNG, WebP)
`quality`	number	Optional	Calitatea compresiei, 10-100. Implicit: 80
`targetSizeKB`	number	Optional	Dimensiunea tinta a fisierului in KB. Suprascrie calitatea daca este setata.
`keepMetadata`	string	Optional	Seteaza la "true" pentru a pastra metadatele 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

Redimensionare imagine

POST/api/image-resize

Redimensioneaza o imagine la dimensiuni specifice sau procentual. Suporta dimensiuni in pixeli si scalare procentuala.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`width`	number	Optional	Latimea tinta in pixeli
`height`	number	Optional	Inaltimea tinta in pixeli
`percentage`	number	Optional	Procent de scalare (de ex. 50 pentru jumatate din dimensiune)
`fit`	string	Optional	"inside" (pastreaza raportul de aspect) sau "fill" (intinde la dimensiunile exacte)

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

Conversie imagine

POST/api/image-convert

Converteste o imagine intre formate. Suporta PNG, JPG, WebP si AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`format`	string	Required	Format tinta: "png", "jpg", "webp" sau "avif"
`quality`	number	Optional	Calitatea rezultatului, 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

Rotire imagine

POST/api/image-rotate

Roteste si/sau rastoarna o imagine. Suporta unghiuri de rotatie arbitrare si rasturnare orizontala/verticala.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`angle`	number	Required	Unghiul de rotatie in grade (de ex. 90, 180, 270)
`flipH`	string	Optional	Seteaza la "true" pentru a rasturna orizontal
`flipV`	string	Optional	Seteaza la "true" pentru a rasturna vertical

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

Decupare imagine

POST/api/image-crop

Decupeaza o imagine la o regiune dreptunghiulara specifica.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`x`	number	Required	Decalajul stang al dreptunghiului de decupare in pixeli
`y`	number	Required	Decalajul superior al dreptunghiului de decupare in pixeli
`width`	number	Required	Latimea dreptunghiului de decupare in pixeli
`height`	number	Required	Inaltimea dreptunghiului de decupare in pixeli

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

Eliminare fundal

POST/api/remove-bg

Elimina automat fundalul dintr-o imagine. Returneaza un PNG cu fundal transparent.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine

Response:Imagine PNG cu fundal transparent

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

Marire rezolutie imagine

POST/api/image-upscale

Mareste rezolutia unei imagini folosind AI pastrand detaliile.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`scale`	number	Optional	Factor de marire: 2 sau 4. Implicit: 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

Estompare fata

POST/api/blur-face

Detecteaza si estompeaza automat toate fetele dintr-o imagine pentru protectia confidentialitatii.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine

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

Filigran imagine

POST/api/watermark-image

Adauga un filigran text pe o imagine. Personalizeaza textul si pozitia.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fisier imagine
`text`	string	Required	Text filigran
`position`	string	Optional	Pozitie: "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