Innehållsmedveten storleksändring

Seam carving-storleksändring som intelligent tar bort eller lägger till pixlar längs banor med minst visuell betydelse, bevarar viktigt innehåll och skyddar valfritt ansikten.

API-slutpunkt

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

Bearbetning: Synkron (returnerar resultatet direkt)

Modellpaket: Inget krävs för grundläggande drift. Ansiktsskydd använder paketet face-detection (200-300 MB) om det är aktiverat.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
file	file	Ja	-	Bildfil (multipart)
width	number	Nej	-	Målbredd i pixlar
height	number	Nej	-	Målhöjd i pixlar
protectFaces	boolean	Nej	false	Upptäck och skydda ansikten från borttagning av sömmar
blurRadius	number	Nej	4	Oskärperadie i förbearbetningen för energiberäkning (0-20)
sobelThreshold	number	Nej	2	Tröskelvärde för Sobel-kantdetektering (1-20). Högre värden gör algoritmen mer aggressiv
square	boolean	Nej	false	Storleksändra till en kvadrat (använder den mindre dimensionen)

Minst en av width, height eller square måste anges.

Exempelbegäran

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

Svar (200 OK)

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

Anteckningar

• Denna anpassade route returnerar för närvarande ett synkront 200-svar.
• Använder seam carving-biblioteket caire för innehållsmedveten storleksändring.
• Minskar endast dimensioner (tar bort sömmar). Kan inte utöka en bild utöver dess ursprungliga storlek.
• Alternativet protectFaces använder AI-ansiktsdetektering för att markera ansiktsområden som högenergi, vilket förhindrar att sömmar passerar genom ansikten.
• blurRadius styr utjämning före beräkningen av energikartan. Högre värden gör energikartan mer enhetlig, vilket kan hjälpa med brusiga bilder.
• sobelThreshold påverkar hur aggressivt kanter upptäcks. Lägre värden bevarar mer subtila kanter.
• Utdatan är alltid i PNG-format.
• Stöder indataformaten HEIC/HEIF, RAW, TGA, PSD, EXR och HDR via automatisk avkodning.