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

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
- format — png (predefinito), jpeg o webp. - quality — un valore da 0 a 1 per la compressione JPEG/WebP. - trim — true (predefinito) ritaglia i margini trasparenti vuoti. - response — image 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.


