Bild-Tools API

Endpunkte fuer Bildkomprimierung, Groessenaenderung, Konvertierung, Drehung, Zuschnitt, Hintergrundentfernung, Hochskalierung, Gesichtsunschaerfe und Wasserzeichen. Alle Endpunkte akzeptieren multipart/form-data und geben das verarbeitete Bild als Binaerdatei zurueck.

Bild komprimieren

POST/api/image-compress

Komprimieren Sie ein Bild, um die Dateigroesse zu reduzieren und gleichzeitig die visuelle Qualitaet beizubehalten. Unterstuetzt JPEG-, PNG- und WebP-Formate.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei (JPG, PNG, WebP)
`quality`	number	Optional	Komprimierungsqualitaet, 10-100. Standard: 80
`targetSizeKB`	number	Optional	Zieldateigroesse in KB. Ueberschreibt die Qualitaet, wenn gesetzt.
`keepMetadata`	string	Optional	Auf "true" setzen, um EXIF-Metadaten beizubehalten

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

Bildgroesse aendern

POST/api/image-resize

Aendern Sie die Groesse eines Bildes auf bestimmte Dimensionen oder prozentual. Unterstuetzt Pixeldimensionen und prozentuale Skalierung.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`width`	number	Optional	Zielbreite in Pixeln
`height`	number	Optional	Zielhoehe in Pixeln
`percentage`	number	Optional	Skalierungsprozentsatz (z.B. 50 fuer halbe Groesse)
`fit`	string	Optional	"inside" (Seitenverhaltnis beibehalten) oder "fill" (auf exakte Dimensionen strecken)

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

Bild konvertieren

POST/api/image-convert

Konvertieren Sie ein Bild zwischen Formaten. Unterstuetzt PNG, JPG, WebP und AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`format`	string	Required	Zielformat: "png", "jpg", "webp" oder "avif"
`quality`	number	Optional	Ausgabequalitaet, 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

Bild drehen

POST/api/image-rotate

Drehen und/oder spiegeln Sie ein Bild. Unterstuetzt beliebige Drehwinkel und horizontales/vertikales Spiegeln.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`angle`	number	Required	Drehwinkel in Grad (z.B. 90, 180, 270)
`flipH`	string	Optional	Auf "true" setzen, um horizontal zu spiegeln
`flipV`	string	Optional	Auf "true" setzen, um vertikal zu spiegeln

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

Bild zuschneiden

POST/api/image-crop

Schneiden Sie ein Bild auf einen bestimmten rechteckigen Bereich zu.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`x`	number	Required	Linker Versatz des Zuschneide-Rechtecks in Pixeln
`y`	number	Required	Oberer Versatz des Zuschneide-Rechtecks in Pixeln
`width`	number	Required	Breite des Zuschneide-Rechtecks in Pixeln
`height`	number	Required	Hoehe des Zuschneide-Rechtecks in Pixeln

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

Hintergrund entfernen

POST/api/remove-bg

Entfernen Sie automatisch den Hintergrund eines Bildes. Gibt ein PNG mit transparentem Hintergrund zurueck.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei

Response:PNG-Bild mit transparentem Hintergrund

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

Bild hochskalieren

POST/api/image-upscale

Skalieren Sie ein Bild mit KI hoch, um die Aufloesung zu erhoehen und dabei Details zu bewahren.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`scale`	number	Optional	Hochskalierungsfaktor: 2 oder 4. Standard: 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

Gesicht unscharf machen

POST/api/blur-face

Erkennen und verwischen Sie automatisch alle Gesichter in einem Bild zum Schutz der Privatsphaere.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei

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

Bild mit Wasserzeichen versehen

POST/api/watermark-image

Fuegen Sie einem Bild ein Text-Wasserzeichen hinzu. Passen Sie Text und Position an.

Parameters

Name	Type	Required	Description
`file`	File	Required	Bilddatei
`text`	string	Required	Wasserzeichen-Text
`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