← Blog
2 min di lettura

API per rimuovere lo sfondo dalle immagini

Integra la rimozione automatica dello sfondo nella tua app con una semplice API HTTP: carichi un'immagine e ottieni un ritaglio trasparente in pochi secondi.

  • api
  • developers
  • tutorial
API per rimuovere lo sfondo dalle immagini

Ora puoi integrare la rimozione automatica dello sfondo di removerbg direttamente nel tuo sito, nella tua app o nel tuo flusso di lavoro. È una semplice API HTTP: invii un'immagine e in pochi secondi ricevi un ritaglio pulito con lo sfondo trasparente.

# Cosa puoi fare

- Carica un'immagine come multipart form data — PNG, JPEG o WebP, fino a 10 MB. - Scegli il formato di output — un PNG trasparente (predefinito) oppure JPEG/WebP con qualità regolabile. - Ricevi il risultato come preferisci — l'immagine binaria diretta oppure una risposta JSON con un URL di download temporaneo.

Ogni richiesta passa dal nostro modello di qualità migliore, quindi non ci sono piani tra cui scegliere: ottieni sempre il ritaglio della qualità più alta. Ogni rimozione riuscita costa 1 credito e le richieste fallite (per esempio una chiave non valida o crediti insufficienti) non vengono mai addebitate.

# Autenticazione

Crea una chiave API dalla tua dashboard e inviala come token Bearer:

`` Authorization: Bearer rmbg_YOUR_API_KEY ``

Ti chiedi che fine fanno le immagini che invii? L'API segue le stesse pratiche del resto del prodotto: ecco il nostro approccio a sicurezza e privacy su remover.bg.

# Avvio rapido

Rimuovi uno sfondo con una sola richiesta:

`` curl -X POST "https://api.remover.bg/remove-bg?format=png" \ -H "Authorization: Bearer rmbg_YOUR_API_KEY" \ -F "file=@photo.jpg" \ --output result.png ``

Oppure da JavaScript:

``` const form = new FormData(); form.append("file", fileInput.files[0]);

const res = await fetch("https://api.remover.bg/remove-bg", { method: "POST", headers: { Authorization: "Bearer rmbgYOURAPI_KEY" }, body: form, });

if (!res.ok) throw new Error(await res.text()); const blob = await res.blob(); // your transparent PNG ```

# Opzioni

- formatpng (predefinito), jpeg o webp. - quality — un valore da 0 a 1 per la compressione JPEG/WebP. - trimtrue (predefinito) ritaglia i margini trasparenti vuoti. - responseimage per il file binario (predefinito) oppure url per una risposta JSON con un link temporaneo (valido per circa 24 ore).

> Ogni risposta include l'header X-Credits-Remaining, così puoi tenere sotto controllo il tuo consumo.

# Elaborazione su larga scala

Una richiesta gestisce una sola immagine, ma lo stesso endpoint regge interi cataloghi: eseguilo al momento del caricamento, in script batch notturni o dentro una pipeline PIM/DAM. La nostra guida alla rimozione dello sfondo in blocco illustra questi schemi, insieme alle tattiche di campionamento per il controllo qualità che mantengono coerenti migliaia di ritagli.

# Inizia in pochi minuti

Con la nostra documentazione API e gli esempi di codice pronti da copiare, puoi essere operativo in pochi minuti. Ci farebbe molto piacere sapere che cosa costruirai.

Continua a leggere