Redimensionnement adapté au contenu

Redimensionnement par découpe de coutures qui retire ou ajoute intelligemment des pixels le long des chemins de moindre importance visuelle, préservant le contenu important et protégeant éventuellement les visages.

API Endpoint

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

Traitement : synchrone (renvoie le résultat directement)

Bundle de modèle : aucun requis pour le fonctionnement de base. La protection des visages utilise le bundle face-detection (200-300 Mo) si elle est activée.

Parameters

Paramètre	Type	Requis	Défaut	Description
file	file	Oui	-	Fichier image (multipart)
width	number	Non	-	Largeur cible en pixels
height	number	Non	-	Hauteur cible en pixels
protectFaces	boolean	Non	false	Détecter et protéger les visages contre la suppression de coutures
blurRadius	number	Non	4	Rayon de flou de prétraitement pour le calcul d'énergie (0-20)
sobelThreshold	number	Non	2	Seuil de détection de contours Sobel (1-20). Les valeurs plus élevées rendent l'algorithme plus agressif
square	boolean	Non	false	Redimensionner en carré (utilise la plus petite dimension)

Au moins l'un des paramètres width, height ou square doit être spécifié.

Example Request

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

Response (200 OK)

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

Notes

• Cette route personnalisée renvoie actuellement une réponse synchrone 200.
• Utilise la bibliothèque de découpe de coutures caire pour le redimensionnement adapté au contenu.
• Réduit uniquement les dimensions (retire des coutures). Ne peut pas agrandir une image au-delà de sa taille d'origine.
• L'option protectFaces utilise la détection de visages par IA pour marquer les régions des visages comme à haute énergie, empêchant les coutures de les traverser.
• blurRadius contrôle le lissage avant le calcul de la carte d'énergie. Les valeurs plus élevées rendent la carte d'énergie plus uniforme, ce qui peut aider avec les images bruitées.
• sobelThreshold influence l'agressivité de la détection des contours. Les valeurs plus basses préservent des contours plus subtils.
• La sortie est toujours au format PNG.
• Prend en charge les formats d'entrée HEIC/HEIF, RAW, TGA, PSD, EXR et HDR par décodage automatique.