L’API di remove.bg sta chiudendo. Cambia una riga, mantieni il codice.
Il sito autonomo e l’API self-service di remove.bg terminano il . L’API passa a Leonardo.Ai (una società di Canva), il che richiede di modificare la tua integrazione (annuncio di Leonardo.Ai). removebackground.dev accetta le stesse richieste: punta il codice al nostro URL, usa la nostra chiave e hai finito.
L’API self-service di remove.bg termina il
L’unica riga che cambia
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgStesso header X-Api-Key, con la tua chiave removebackground.dev. Stessi nomi dei parametri, stessi header di risposta, stesso formato degli errori {"errors": [...]}.
Prima e dopo
Un’integrazione tipica in quattro linguaggi. La chiave arriva da REMOVEBG_API_KEY, quindi l’unica modifica è l’URL evidenziato.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Usi Zapier, Make o n8n?
Apri lo step di richiesta HTTP che chiama remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), cambia l’URL in https://removebackground.dev/v1.0/removebg e il valore di X-Api-Key con la tua chiave removebackground.dev. Lascia invariati tutti gli altri campi.
Compatibilità dei parametri
Tutto ciò che invia la tua richiesta a remove.bg viene accettato. Alcune opzioni qui non hanno effetto, come indicato sotto.
| Parametro | Stato | Note |
|---|---|---|
image_file / image_file_b64 / image_url | Supportato | Body multipart, urlencoded o JSON. JPG, PNG o WebP fino a 25 MB. |
size | Supportato | auto, full, 4k e 50MP restituiscono la risoluzione originale (fino a 25 MP); preview, small e regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Sempre 1 credito. |
format | Supportato | auto (PNG se trasparente, altrimenti JPG), png, jpg, webp e zip (color.jpg + alpha.png). |
crop / crop_margin | Supportato | px o % del soggetto, da 1 a 4 valori in stile CSS ("10% 20%" = verticale, orizzontale); al massimo 500px o 50% per lato. |
roi | Supportato | "x1 y1 x2 y2" in px o %: viene mantenuto solo il soggetto all’interno dell’area. |
scale / position | Supportato | scale dal 10% al 100% oppure original; position center, original o "x% y%". |
channels | Supportato | rgba (scontorno) o alpha (maschera in scala di grigi). |
bg_color | Supportato | Esadecimale con o senza # (81d4fa), oppure il nome di un colore. Un esadecimale a 8 cifre mantiene il colore e ne ignora l’alfa. |
bg_image_url / bg_image_file | Supportato | Lo scontorno viene sovrapposto alla tua immagine di sfondo, adattata in modalità cover alle dimensioni di output. |
Accept: application/json | Supportato | Restituisce { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Accettato, ignorato | Il soggetto viene rilevato automaticamente; X-Type è sempre "other". |
semitransparency | Accettato, ignorato | Bordi morbidi e aree semitrasparenti provengono così come sono dalla maschera del modello. |
shadow_type / shadow_opacity / add_shadow | Accettato, ignorato | Non vengono aggiunte ombre. |
Richieste lunghe | Differenza | Attendiamo fino a 110 secondi; se un’immagine non è pronta entro quel tempo ricevi un 503 da ripetere (non addebitato a meno che l’elaborazione non sia terminata). |
Header di risposta
Una chiamata riuscita risponde con i byte dell’immagine (image/png, image/jpeg, image/webp o application/zip) e questi header. Invia Accept: application/json per ricevere invece result_b64.
| Header | Significato |
|---|---|
X-Width / X-Height | Dimensioni del risultato in pixel. |
X-Credits-Charged | Crediti usati da questa immagine: sempre 1 (le immagini non riuscite costano 0). |
X-Type | Sempre "other" (il rilevamento del soggetto è automatico). |
X-Foreground-Top / -Left / -Width / -Height | Riquadro di delimitazione del soggetto nel risultato, in pixel. |
X-Request-ID | Riporta il tuo X-Request-ID, oppure un id generato. Extra. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Quanto è pulita la maschera (0–1) e la quota di pixel morbidi. Extra: utile per segnalare immagini da controllare. |
Errori
| Stato | Significato |
|---|---|
400 | Parametro o immagine non validi (codici come invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: ricarica dalla pagina dei prezzi. |
403 | auth_failed: X-Api-Key mancante o non valido. |
429 | rate_limit_exceeded. |
500 / 503 | Elaborazione non riuscita, tempo scaduto o servizio momentaneamente non disponibile. Riprova; le immagini non riuscite sono gratuite. |
Controlla il saldo con GET https://removebackground.dev/v1.0/account: la risposta ha la struttura dell’account di remove.bg. Tutti i dettagli nella reference dell’API.
Crediti: 1 per immagine, e non scadono mai
Ogni immagine riuscita costa 1 credito, qualunque siano dimensioni o opzioni. Le immagini non riuscite sono gratuite. I nuovi account ricevono 50 crediti gratuiti per fare prove.
- I crediti non scadono maiRicarichi una volta e li usi la prossima settimana o il prossimo anno.
- Nessun abbonamentoPacchetti una tantum. Nulla si rinnova.
- Le immagini non riuscite sono gratisUn credito si usa solo quando lo sfondo viene rimosso.
Checklist di migrazione
- Ottieni una chiave API removebackground.devRegistrati (50 crediti gratuiti) e crea una chiave nella pagina del tuo account.
- Cambia una rigaPunta il codice a https://removebackground.dev/v1.0/removebg e inserisci la nuova chiave nello stesso header X-Api-Key.
- Prova un’immagineEsegui una richiesta reale e confronta l’output con quello che ottieni oggi.
- Sposta il trafficoFai il deploy prima del 1 dicembre 2026 alle ore 09:00 CET. Ricarica i crediti una volta; non scadono mai.
FAQ sulla migrazione da remove.bg
remove.bg sta chiudendo?
Il sito autonomo e l’API self-service di remove.bg terminano il 1 dicembre 2026 alle ore 09:00 CET. L’API passa a Leonardo.Ai (una società di Canva), il che richiede di modificare la tua integrazione. Fonte: l’annuncio di Leonardo.Ai su https://www.leonardo.ai/news/removebg-api-leonardo.
Qual è il sostituto più semplice dell’API di remove.bg?
removebackground.dev ha un endpoint compatibile con remove.bg. Sostituisci https://api.remove.bg/v1.0/removebg con https://removebackground.dev/v1.0/removebg, invia una chiave removebackground.dev nello stesso header X-Api-Key e mantieni il resto del codice: nomi dei parametri, header di risposta e formato degli errori coincidono.
Devo riscrivere la mia integrazione prima di dicembre 2026?
No. Le richieste mantengono gli stessi parametri (image_file, image_url, size, format, crop, bg_color…) e ricevono lo stesso tipo di risposta: i byte dell’immagine con gli header X-Width, X-Height e X-Foreground-*, oppure JSON con result_b64. Cambiano solo URL e chiave.
Funziona con Zapier, Make o n8n?
Sì. Nello step di richiesta HTTP (Zapier Webhooks, Make HTTP, n8n HTTP Request) cambia l’URL in https://removebackground.dev/v1.0/removebg e il valore di X-Api-Key con la tua chiave removebackground.dev. Nient’altro cambia.
Quanto costa?
1 credito per immagine riuscita, qualunque siano dimensioni o opzioni. Nessun abbonamento: ricariche una tantum da 17 USD, 49 USD o 99 USD, e i crediti non scadono mai. Le immagini non riuscite sono gratuite. I nuovi account ricevono 50 crediti gratuiti.
Quali parametri di remove.bg sono supportati?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url e bg_image_file. type, type_level, semitransparency e le opzioni shadow vengono accettati e ignorati, quindi le richieste che li inviano continuano a funzionare.
Posso controllare il saldo come prima?
Sì. GET https://removebackground.dev/v1.0/account con la tua chiave restituisce i crediti nel formato account di remove.bg.
removebackground.dev è affiliato a remove.bg?
No. remove.bg è un marchio del rispettivo titolare. removebackground.dev è un servizio indipendente che accetta le stesse richieste API.
Passa a noi prima del 1 dicembre 2026 alle ore 09:00 CET
L’API self-service di remove.bg termina il
Crea una chiave, cambia una riga, prova un’immagine. 50 crediti gratuiti inclusi.
remove.bg è un marchio del rispettivo titolare; removebackground.dev non è affiliato.