Miglioramento Immagine

Miglioramento automatico con un clic e analisi intelligente. Analizza l'immagine e applica correzioni di esposizione, contrasto, bilanciamento del bianco, saturazione, nitidezza e riduzione del rumore.

Endpoint API

POST /api/v1/tools/image/image-enhancement

Elaborazione: Sincrona (usa la factory createToolRoute, restituisce il risultato direttamente)

Model bundle: Nessuno richiesto per il miglioramento di base. Il bundle upscale-enhance (5-6 GB) viene usato solo quando deepEnhance è abilitato (per la rimozione del rumore tramite IA con SCUNet).

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
file	file	Sì	-	File immagine (multipart)
mode	string	No	"auto"	Modalità di miglioramento: auto, portrait, landscape, low-light, food, document
intensity	number	No	50	Intensità complessiva del miglioramento (0-100)
corrections	object	No	tutte true	Correzioni selettive da applicare (vedi sotto)
deepEnhance	boolean	No	false	Abilita la rimozione del rumore basata su IA (richiede lo strumento noise-removal installato)

Oggetto Corrections

Campo	Tipo	Predefinito	Descrizione
exposure	boolean	true	Correzione automatica dell'esposizione
contrast	boolean	true	Correzione automatica del contrasto
whiteBalance	boolean	true	Correzione automatica del bilanciamento del bianco
saturation	boolean	true	Correzione automatica della saturazione
sharpness	boolean	true	Nitidezza automatica
denoise	boolean	true	Riduzione leggera del rumore

Richiesta di Esempio

curl -X POST http://localhost:1349/api/v1/tools/image/image-enhancement \
  -F "[email protected]" \
  -F 'settings={"mode":"portrait","intensity":70,"corrections":{"exposure":true,"contrast":true,"sharpness":false}}'

Risposta (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/photo.jpg",
  "originalSize": 300000,
  "processedSize": 310000
}

Endpoint Analyze

POST /api/v1/tools/image/image-enhancement/analyze

Analizza un'immagine e restituisce raccomandazioni di correzione senza applicarle.

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
file	file	Sì	File immagine (multipart)

Richiesta di Esempio

curl -X POST http://localhost:1349/api/v1/tools/image/image-enhancement/analyze \
  -F "[email protected]"

Risposta (200 OK)

{
  "corrections": {
    "exposure": { "value": 0.3, "direction": "brighten" },
    "contrast": { "value": 0.2, "direction": "increase" },
    "whiteBalance": { "value": 200, "direction": "warmer" },
    "saturation": { "value": 0.1, "direction": "increase" },
    "sharpness": { "value": 0.4, "direction": "sharpen" }
  }
}

Note

• Questo strumento usa la factory sincrona createToolRoute, quindi restituisce una risposta standard (non 202 asincrona).
• Il parametro mode regola come vengono ponderate le correzioni (es. la modalità ritratto è più delicata sui toni della pelle, la modalità paesaggio aumenta la saturazione).
• Quando deepEnhance è abilitato e lo strumento noise-removal (SCUNet) è installato, viene applicata un'ulteriore passata di riduzione del rumore tramite IA dopo le correzioni standard.
• L'endpoint analyze è utile per visualizzare in anteprima quali correzioni verrebbero applicate prima di confermare.
• Supporta i formati di input HEIC/HEIF, RAW, TGA, PSD, EXR e HDR tramite decodifica automatica.