Files
SnapOtter/apps/docs/it/tools/image/erase-object.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Rimuovi oggetti indesiderati dalle immagini con l'inpainting IA (LaMa), guidato da una maschera della regione da cancellare. 8e2e42a5e4f9 human 0d2755e07356

Gomma per oggetti

Rimuovi oggetti indesiderati dalle immagini usando l'inpainting IA (modello LaMa). Accetta un'immagine e una maschera che indica la regione da cancellare.

Endpoint API

POST /api/v1/tools/image/erase-object

Elaborazione: Asincrona (restituisce 202, esegui il polling di /api/v1/jobs/{jobId}/progress per lo stato tramite SSE)

Bundle del modello: object-eraser-colorize (1-2 GB)

Parametri

Parametro Tipo Obbligatorio Predefinito Descrizione
file file - File immagine di origine (multipart)
mask file - Immagine maschera (bianco = area da cancellare, nero = mantieni). Deve essere caricata con il fieldname mask
format string No "auto" Formato di output: auto, png, jpg, jpeg, webp, tiff, gif, avif, heic, heif, jxl
quality integer No 95 Qualità di output (1-100)

Esempio di richiesta

curl -X POST http://localhost:1349/api/v1/tools/image/erase-object \
  -F "file=@photo.jpg" \
  -F "mask=@mask.png" \
  -F "format=png" \
  -F "quality=95"

Risposta

Risposta iniziale (202 Accepted)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Avanzamento (SSE su /api/v1/jobs/{jobId}/progress)

event: progress
data: {"phase":"processing","stage":"Inpainting...","percent":70}

Risultato finale (tramite SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/photo_erased.png",
    "previewUrl": "/api/v1/download/{jobId}/preview.webp",
    "originalSize": 245000,
    "processedSize": 230000
  }
}

Note

  • Richiede l'installazione del bundle del modello object-eraser-colorize (1-2 GB).
  • La maschera deve avere le stesse dimensioni dell'immagine di origine. I pixel bianchi indicano le aree da cancellare; l'IA le riempie con contenuto plausibile.
  • Usa LaMa (Large Mask Inpainting) per una rimozione degli oggetti di alta qualità.
  • Per i formati di output non visualizzabili in anteprima nel browser, viene generata un'anteprima WebP insieme all'output principale.
  • Supporta i formati di input HEIC/HEIF, RAW, TGA, PSD, EXR e HDR tramite decodifica automatica.