Sviluppatori

API per rimuovere lo sfondo

Le stesse richieste dell'API di remove.bg, le stesse risposte. Cambia l'URL di base e la chiave; il resto del codice non cambia.

Passare da remove.bg

remove.bg ha annunciato che il suo servizio autonomo chiude il 1° dicembre 2026 e che lo stesso giorno si fermano le richieste all'API self-service, che passa a Leonardo.Ai. Se il tuo codice chiama api.remove.bg, puntalo qui:

Primahttps://api.remove.bg/v1.0/removebg
Dopohttps://imagic-ai.com/api/v1.0/removebg

L'header resta X-Api-Key, i campi mantengono i loro nomi e gli errori il formato di remove.bg, quindi le librerie client che permettono di impostare l'URL di base funzionano così come sono.

Cosa cambia con la chiusura del 1° dicembre e cosa fare per prima cosa

Ottieni una chiave

  1. Accedi con Google.
  2. Apri Il mio account e crea una chiave in «Chiavi dell'API per rimuovere lo sfondo».
  3. Copia la chiave quando compare. Viene mostrata una sola volta.
Crea una chiave

Avvio rapido

Invia l'immagine come file, in base64 o come URL pubblico. Il corpo della risposta è l'immagine finita.

curl
curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg
Python
import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Node.js
import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

Campi della richiesta

POST /api/v1.0/removebg accetta multipart/form-data, application/x-www-form-urlencoded o JSON. Invia uno solo dei tre campi immagine.

CampoValoriNote
image_filefileJPG, PNG o WebP fino a 22 MB.
image_file_b64stringa base64Lo stesso file in base64. È accettato il prefisso data: URL.
image_urlURL http(s)La scarichiamo noi. Solo indirizzi pubblici e porte web standard, fino a 3 reindirizzamenti.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: fino a 0,25 MP. medium: 1,5 MP. hd: 4 MP. full/4k/auto/50MP: fino a 25 MP (PNG fino a 10 MP). Ogni dimensione conta come un'immagine.
formatauto · png · jpg · webp · zipauto restituisce PNG se il risultato è trasparente, altrimenti JPG. zip contiene color.jpg e alpha.png, come su remove.bg.
channelsrgba · alphaalpha restituisce solo la maschera, in scala di grigi.
bg_colorhex (81d4fa, #81d4fa77) o nome di coloreRiempie lo sfondo rimosso. Un JPG senza bg_color viene appiattito su bianco.
croptrue · falseRitaglia il risultato sul soggetto.
crop_margines. 30px o 10%Spazio attorno al soggetto ritagliato. Fino a 500px o 50%.
typeauto · person · product · car · animal · graphic · transportationAccettato per compatibilità. Viene restituito in X-Type; non cambia il ritaglio.
modelfast · preciseOpzione nostra (remove.bg non ce l'ha). fast, il predefinito: il nostro modello standard. precise: bordi più fini su capelli, parti sottili e vetro, un po' più lento. Entrambi contano come un'immagine; l'header X-Imagic-Model indica quale è stato usato.

scale, position, roi, bg_image_url, bg_image_file e le opzioni d'ombra non sono supportati. Le richieste che li usano ricevono un 400 invece di un'immagine diversa senza avviso.

Risposta

Per impostazione predefinita il corpo è l'immagine stessa, con questi header: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (sempre 1) e X-RateLimit-Limit / -Remaining / -Reset per la quota giornaliera. Un'immagine pagata con un credito riporta anche X-Imagic-Paid: 1 e X-Imagic-Credit-Balance. Invia Accept: application/json per ricevere JSON:

Accept: application/json
{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

Quota rimanente

GET /api/v1.0/account restituisce la struttura account di remove.bg. api.free_calls indica le immagini gratuite rimaste oggi, credits.payg il saldo crediti dell'account e credits.total la somma dei due.

Errori

Gli errori usano il formato di remove.bg, mostrato qui sotto. Una richiesta fallita non consuma immagini.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
StatoSignificato
400Input non valido: nessuna immagine, due immagini, file illeggibile, opzione non supportata o una image_url che non possiamo o non riusciamo a scaricare.
403L'header X-Api-Key manca, è errato o revocato.
422Il modello richiesto non è disponibile al momento (codice model_unavailable). Riprova con model=fast; l'immagine non viene conteggiata.
429Le 50 immagini gratuite di oggi sono esaurite e l'account non ha più crediti, oppure ha raggiunto 1.000 immagini a pagamento oggi. Retry-After indica i secondi al ripristino delle immagini gratuite.
503L'elaborazione non è disponibile al momento. Riprova tra poco.

Limiti

  • 50 immagini al giorno per account, condivise da tutte le chiavi. Fino a 3 chiavi attive per account, così puoi ruotarle.
  • Caricamenti fino a 22 MB. Output fino a 25 MP, o 10 MP in PNG.
  • Le richieste vengono messe in coda ed elaborate poche alla volta. Calcola qualche secondo per immagine, di più per le foto grandi.
  • Dopo le 50 immagini gratuite, ogni immagine usa un credito dal saldo dell'account, fino a 1.000 immagini a pagamento al giorno. I crediti si acquistano nella pagina dell'account (100 per 5 US$ o 500 per 19 US$) e non scadono.

Cosa aspettarsi dai ritagli

I ritagli vengono dal modello isnet-general-use, lo stesso di Rimuovi Sfondo. È affidabile con prodotti, persone e animali su sfondi comuni. I suoi punti deboli sono capelli sottili, vetro e soggetti dello stesso colore dello sfondo, dove il modello di remove.bg può fare meglio. Prova con alcune tue immagini prima di spostare un flusso in produzione.

Domande

È un sostituto ufficiale di remove.bg?
No. Imagic AI non è affiliata a remove.bg, Canva o Leonardo.Ai. L'API accetta il formato di richiesta di remove.bg perché il codice esistente continui a funzionare.
L'API è gratuita?
Sì. Ogni account ha 50 immagini al giorno senza costi. Ogni dimensione, preview compresa, conta come un'immagine. Oltre, ogni immagine usa un credito (100 crediti costano 5 US$).
Le librerie client ufficiali di remove.bg funzionano?
Quelle che permettono di impostare l'URL di base funzionano cambiandolo in https://imagic-ai.com/api. Quelle con api.remove.bg fisso richiedono di modificare quella riga nel codice o un piccolo wrapper.
Conservate le mie immagini?
Le immagini inviate all'API vengono elaborate e restituite nella risposta. Non finiscono in nessuna galleria e non vengono usate per l'addestramento.

Ti servono solo poche immagini, senza codice?

Usa Rimuovi Sfondo