Afbeeldingstools API

Endpoints voor beeldcompressie, formaat wijzigen, conversie, rotatie, bijsnijden, achtergrondverwijdering, opschalen, gezichtsvervaging en watermerken. Alle endpoints accepteren multipart/form-data en retourneren de verwerkte afbeelding als binair bestand.

Afbeelding comprimeren

POST/api/image-compress

Comprimeer een afbeelding om de bestandsgrootte te verkleinen met behoud van visuele kwaliteit. Ondersteunt JPEG, PNG en WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand (JPG, PNG, WebP)
`quality`	number	Optional	Compressiekwaliteit, 10-100. Standaard: 80
`targetSizeKB`	number	Optional	Doelbestandsgrootte in KB. Overschrijft quality indien ingesteld.
`keepMetadata`	string	Optional	Stel in op "true" om EXIF-metadata te behouden

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

Afbeelding formaat wijzigen

POST/api/image-resize

Wijzig het formaat van een afbeelding naar specifieke afmetingen of op percentage. Ondersteunt pixelafmetingen en percentageschaling.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`width`	number	Optional	Doelbreedte in pixels
`height`	number	Optional	Doelhoogte in pixels
`percentage`	number	Optional	Schaalpercentage (bijv. 50 voor de helft)
`fit`	string	Optional	"inside" (beeldverhouding behouden) of "fill" (uitrekken naar exacte afmetingen)

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

Afbeelding converteren

POST/api/image-convert

Converteer een afbeelding tussen formaten. Ondersteunt PNG, JPG, WebP en AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`format`	string	Required	Doelformaat: "png", "jpg", "webp" of "avif"
`quality`	number	Optional	Uitvoerkwaliteit, 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

Afbeelding roteren

POST/api/image-rotate

Roteer en/of spiegel een afbeelding. Ondersteunt willekeurige rotatiehoeken en horizontaal/verticaal spiegelen.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`angle`	number	Required	Rotatiehoek in graden (bijv. 90, 180, 270)
`flipH`	string	Optional	Stel in op "true" om horizontaal te spiegelen
`flipV`	string	Optional	Stel in op "true" om verticaal te spiegelen

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

Afbeelding bijsnijden

POST/api/image-crop

Snijd een afbeelding bij tot een specifiek rechthoekig gebied.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`x`	number	Required	Linker offset van het bijsnijdrechthoek in pixels
`y`	number	Required	Bovenste offset van het bijsnijdrechthoek in pixels
`width`	number	Required	Breedte van het bijsnijdrechthoek in pixels
`height`	number	Required	Hoogte van het bijsnijdrechthoek in 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

Achtergrond verwijderen

POST/api/remove-bg

Verwijder automatisch de achtergrond van een afbeelding. Retourneert een PNG met transparante achtergrond.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand

Response:PNG-afbeelding met transparante achtergrond

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

Afbeelding opschalen

POST/api/image-upscale

Schaal een afbeelding op met AI om de resolutie te verhogen met behoud van detail.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`scale`	number	Optional	Opschaalfactor: 2 of 4. Standaard: 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

Gezicht vervagen

POST/api/blur-face

Detecteer en vervaag automatisch alle gezichten in een afbeelding voor privacybescherming.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand

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

Watermerk op afbeelding

POST/api/watermark-image

Voeg een tekstwatermerk toe aan een afbeelding. Pas de tekst en positie aan.

Parameters

Name	Type	Required	Description
`file`	File	Required	Afbeeldingsbestand
`text`	string	Required	Watermerktekst
`position`	string	Optional	Positie: "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