Inhaltsbasierte Skalierung

Seam-Carving-Skalierung, die Pixel entlang der Pfade mit der geringsten visuellen Bedeutung intelligent entfernt oder hinzufügt, dabei wichtige Inhalte bewahrt und optional Gesichter schützt.

API-Endpunkt

POST /api/v1/tools/image/content-aware-resize

Verarbeitung: Synchron (gibt das Ergebnis direkt zurück)

Modell-Bundle: Für den Grundbetrieb keines erforderlich. Der Gesichtsschutz verwendet, sofern aktiviert, das Bundle face-detection (200-300 MB).

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
file	file	Ja	-	Bilddatei (Multipart)
width	number	Nein	-	Zielbreite in Pixeln
height	number	Nein	-	Zielhöhe in Pixeln
protectFaces	boolean	Nein	false	Gesichter erkennen und vor der Seam-Entfernung schützen
blurRadius	number	Nein	4	Weichzeichnungsradius für die Vorverarbeitung zur Energieberechnung (0-20)
sobelThreshold	number	Nein	2	Schwellenwert für die Sobel-Kantenerkennung (1-20). Höhere Werte machen den Algorithmus aggressiver
square	boolean	Nein	false	Auf ein Quadrat skalieren (verwendet die kleinere Abmessung)

Mindestens eines von width, height oder square muss angegeben werden.

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "[email protected]" \
  -F 'settings={"width":800,"protectFaces":true}'

Antwort (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Hinweise

• Diese benutzerdefinierte Route gibt derzeit eine synchrone 200-Antwort zurück.
• Verwendet die Seam-Carving-Bibliothek caire für die inhaltsbasierte Skalierung.
• Verkleinert nur die Abmessungen (entfernt Seams). Kann ein Bild nicht über seine ursprüngliche Größe hinaus vergrößern.
• Die Option protectFaces nutzt die KI-Gesichtserkennung, um Gesichtsbereiche als hochenergetisch zu markieren und zu verhindern, dass Seams durch Gesichter verlaufen.
• blurRadius steuert die Glättung vor der Berechnung der Energiekarte. Höhere Werte machen die Energiekarte gleichmäßiger, was bei verrauschten Bildern helfen kann.
• sobelThreshold beeinflusst, wie aggressiv Kanten erkannt werden. Niedrigere Werte bewahren feinere Kanten.
• Die Ausgabe ist immer im PNG-Format.
• Unterstützt die Eingabeformate HEIC/HEIF, RAW, TGA, PSD, EXR und HDR durch automatische Dekodierung.