API d'outils d'image

Endpoints pour la compression, le redimensionnement, la conversion, la rotation, le recadrage, la suppression d'arriere-plan, la mise a l'echelle, le floutage de visages et le filigranage d'images. Tous les endpoints acceptent multipart/form-data et renvoient l'image traitee sous forme de fichier binaire.

Compresser une image

POST/api/image-compress

Compressez une image pour reduire la taille du fichier tout en maintenant la qualite visuelle. Supporte les formats JPEG, PNG et WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image (JPG, PNG, WebP)
`quality`	number	Optional	Qualite de compression, 10-100. Par defaut : 80
`targetSizeKB`	number	Optional	Taille cible du fichier en Ko. Remplace la qualite si defini.
`keepMetadata`	string	Optional	Definissez sur "true" pour preserver les metadonnees 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

Redimensionner une image

POST/api/image-resize

Redimensionnez une image a des dimensions specifiques ou par pourcentage. Supporte les dimensions en pixels et la mise a l'echelle par pourcentage.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`width`	number	Optional	Largeur cible en pixels
`height`	number	Optional	Hauteur cible en pixels
`percentage`	number	Optional	Pourcentage de mise a l'echelle (ex. 50 pour la moitie de la taille)
`fit`	string	Optional	"inside" (conserver le ratio) ou "fill" (etirer aux dimensions exactes)

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

Convertir une image

POST/api/image-convert

Convertissez une image entre les formats. Supporte PNG, JPG, WebP et AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`format`	string	Required	Format cible : "png", "jpg", "webp" ou "avif"
`quality`	number	Optional	Qualite de sortie, 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

Pivoter une image

POST/api/image-rotate

Pivotez et/ou retournez une image. Supporte des angles de rotation arbitraires et le retournement horizontal/vertical.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`angle`	number	Required	Angle de rotation en degres (ex. 90, 180, 270)
`flipH`	string	Optional	Definissez sur "true" pour retourner horizontalement
`flipV`	string	Optional	Definissez sur "true" pour retourner verticalement

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

Recadrer une image

POST/api/image-crop

Recadrez une image a une region rectangulaire specifique.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`x`	number	Required	Decalage gauche du rectangle de recadrage en pixels
`y`	number	Required	Decalage superieur du rectangle de recadrage en pixels
`width`	number	Required	Largeur du rectangle de recadrage en pixels
`height`	number	Required	Hauteur du rectangle de recadrage en pixels

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

Supprimer l'arriere-plan

POST/api/remove-bg

Supprimez automatiquement l'arriere-plan d'une image. Renvoie un PNG avec un arriere-plan transparent.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image

Response:Image PNG avec arriere-plan 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

Agrandir une image

POST/api/image-upscale

Agrandissez une image en utilisant l'IA pour augmenter la resolution tout en preservant les details.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`scale`	number	Optional	Facteur d'agrandissement : 2 ou 4. Par defaut : 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

Flouter les visages

POST/api/blur-face

Detectez et floutez automatiquement tous les visages dans une image pour la protection de la vie privee.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image

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

Filigrane sur image

POST/api/watermark-image

Ajoutez un filigrane textuel a une image. Personnalisez le texte et la position.

Parameters

Name	Type	Required	Description
`file`	File	Required	Fichier image
`text`	string	Required	Texte du filigrane
`position`	string	Optional	Position : "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