DocsΕργαλεία εικόνας

API Εργαλείων εικόνων

Τελικά σημεία για συμπίεση εικόνων, αλλαγή μεγέθους, μετατροπή, περιστροφή, περικοπή, αφαίρεση φόντου, αναβάθμιση ανάλυσης, θόλωμα προσώπων και υδατοσήμανση. Όλα τα τελικά σημεία δέχονται multipart/form-data και επιστρέφουν την επεξεργασμένη εικόνα ως δυαδικό αρχείο.

Συμπίεση εικόνας

POST/api/image-compress

Συμπιέστε μια εικόνα για μείωση του μεγέθους αρχείου διατηρώντας την οπτική ποιότητα. Υποστηρίζει μορφές JPEG, PNG και WebP.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας (JPG, PNG, WebP)
qualitynumberOptionalΠοιότητα συμπίεσης, 10-100. Προεπιλογή: 80
targetSizeKBnumberOptionalΣτόχος μεγέθους αρχείου σε KB. Υπερισχύει της ποιότητας αν οριστεί.
keepMetadatastringOptionalΟρίστε σε "true" για διατήρηση μεταδεδομένων 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

Αλλαγή μεγέθους εικόνας

POST/api/image-resize

Αλλάξτε το μέγεθος μιας εικόνας σε συγκεκριμένες διαστάσεις ή κατά ποσοστό. Υποστηρίζει διαστάσεις σε pixel και ποσοστιαία κλιμάκωση.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
widthnumberOptionalΠλάτος στόχου σε pixel
heightnumberOptionalΎψος στόχου σε pixel
percentagenumberOptionalΠοσοστό κλιμάκωσης (π.χ. 50 για μισό μέγεθος)
fitstringOptional"inside" (διατήρηση αναλογίας) ή "fill" (τέντωμα σε ακριβείς διαστάσεις)
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

Μετατροπή εικόνας

POST/api/image-convert

Μετατρέψτε μια εικόνα μεταξύ μορφών. Υποστηρίζει PNG, JPG, WebP και AVIF.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
formatstringRequiredΜορφή στόχου: "png", "jpg", "webp" ή "avif"
qualitynumberOptionalΠοιότητα εξόδου, 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

Περιστροφή εικόνας

POST/api/image-rotate

Περιστρέψτε ή/και αναστρέψτε μια εικόνα. Υποστηρίζει αυθαίρετες γωνίες περιστροφής και οριζόντια/κατακόρυφη αναστροφή.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
anglenumberRequiredΓωνία περιστροφής σε μοίρες (π.χ. 90, 180, 270)
flipHstringOptionalΟρίστε σε "true" για οριζόντια αναστροφή
flipVstringOptionalΟρίστε σε "true" για κατακόρυφη αναστροφή
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

Περικοπή εικόνας

POST/api/image-crop

Περικόψτε μια εικόνα σε μια συγκεκριμένη ορθογώνια περιοχή.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
xnumberRequiredΑριστερή μετατόπιση του ορθογωνίου περικοπής σε pixel
ynumberRequiredΕπάνω μετατόπιση του ορθογωνίου περικοπής σε pixel
widthnumberRequiredΠλάτος του ορθογωνίου περικοπής σε pixel
heightnumberRequiredΎψος του ορθογωνίου περικοπής σε 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

Αφαίρεση φόντου

POST/api/remove-bg

Αφαιρέστε αυτόματα το φόντο από μια εικόνα. Επιστρέφει PNG με διαφανές φόντο.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
Response:Εικόνα PNG με διαφανές φόντο
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

Αναβάθμιση ανάλυσης εικόνας

POST/api/image-upscale

Αναβαθμίστε την ανάλυση μιας εικόνας χρησιμοποιώντας AI διατηρώντας τη λεπτομέρεια.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
scalenumberOptionalΣυντελεστής αναβάθμισης: 2 ή 4. Προεπιλογή: 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

Θόλωμα προσώπου

POST/api/blur-face

Εντοπίστε και θολώστε αυτόματα όλα τα πρόσωπα σε μια εικόνα για προστασία ιδιωτικότητας.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
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

Υδατοσήμανση εικόνας

POST/api/watermark-image

Προσθέστε κειμενικό υδατόσημο σε μια εικόνα. Προσαρμόστε το κείμενο και τη θέση.

Parameters

NameTypeRequiredDescription
fileFileRequiredΑρχείο εικόνας
textstringRequiredΚείμενο υδατοσήμου
positionstringOptionalΘέση: "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