API per rimuovere lo sfondo

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:

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.

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.

Avvio rapido

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

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

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)

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.

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. Invia Accept: application/json per ricevere 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. credits.total e api.free_calls indicano entrambi le immagini rimaste oggi.

Errori

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

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}

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.
• Non c'è ancora un piano a pagamento, quindi per ora la quota giornaliera è il tetto.

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.

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.