Entwickler

API zum Entfernen von Hintergründen

Dieselben Anfragen wie die remove.bg-API, dieselben Antworten. Basis-URL und Schlüssel ändern, der Rest des Codes bleibt.

Umstieg von remove.bg

remove.bg hat angekündigt, dass sein eigenständiger Dienst am 1. Dezember 2026 schließt und Self-Service-API-Anfragen am selben Tag enden; die API wandert zu Leonardo.Ai. Wenn dein Code api.remove.bg aufruft, richte ihn hierhin:

Vorherhttps://api.remove.bg/v1.0/removebg
Nachherhttps://imagic-ai.com/api/v1.0/removebg

Der Header bleibt X-Api-Key, die Felder behalten ihre Namen und Fehler das Format von remove.bg. Client-Bibliotheken, bei denen sich die Basis-URL einstellen lässt, funktionieren unverändert.

Was sich mit der Abschaltung am 1. Dezember ändert und was zuerst zu tun ist

Schlüssel holen

  1. Mit Google anmelden.
  2. Mein Konto öffnen und unter „API-Schlüssel zum Freistellen“ einen Schlüssel erstellen.
  3. Den Schlüssel kopieren, sobald er erscheint. Er wird nur einmal angezeigt.
Schlüssel erstellen

Schnellstart

Sende das Bild als Datei-Upload, als Base64 oder als öffentliche URL. Der Antwortinhalt ist das fertige Bild.

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()));

Anfragefelder

POST /api/v1.0/removebg akzeptiert multipart/form-data, application/x-www-form-urlencoded oder JSON. Sende genau eines der drei Bildfelder.

FeldWerteHinweise
image_fileDateiJPG, PNG oder WebP bis 22 MB.
image_file_b64Base64-StringDieselbe Datei als Base64. Ein data:-URL-Präfix wird akzeptiert.
image_urlhttp(s)-URLWir laden sie herunter. Nur öffentliche Adressen und Standard-Webports, bis zu 3 Weiterleitungen.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: bis 0,25 MP. medium: 1,5 MP. hd: 4 MP. full/4k/auto/50MP: bis 25 MP (PNG bis 10 MP). Jede Größe zählt als ein Bild.
formatauto · png · jpg · webp · zipauto liefert PNG, wenn das Ergebnis transparent ist, sonst JPG. zip enthält color.jpg und alpha.png wie bei remove.bg.
channelsrgba · alphaalpha liefert nur die Maske in Graustufen.
bg_colorHex (81d4fa, #81d4fa77) oder FarbnameFüllt den entfernten Hintergrund. Ein JPG ohne bg_color wird auf Weiß gelegt.
croptrue · falseSchneidet das Ergebnis auf das Motiv zu.
crop_marginz. B. 30px oder 10%Rand um das zugeschnittene Motiv. Bis 500px oder 50%.
typeauto · person · product · car · animal · graphic · transportationAus Kompatibilitätsgründen akzeptiert. Wird in X-Type zurückgegeben, ändert die Freistellung nicht.
modelfast · preciseEigene Option (remove.bg hat sie nicht). fast, der Standard: unser Standardmodell. precise: feinere Kanten bei Haaren, dünnen Teilen und Glas, etwas langsamer. Beide zählen als ein Bild; der Header X-Imagic-Model nennt das verwendete Modell.

scale, position, roi, bg_image_url, bg_image_file und Schattenoptionen werden nicht unterstützt. Anfragen damit erhalten einen 400er statt stillschweigend ein anderes Bild.

Antwort

Standardmäßig ist der Antwortinhalt das Bild selbst, mit diesen Headern: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (immer 1) sowie X-RateLimit-Limit / -Remaining / -Reset für das Tageskontingent. Ein mit einem Credit bezahltes Bild trägt zusätzlich X-Imagic-Paid: 1 und X-Imagic-Credit-Balance. Mit Accept: application/json gibt es stattdessen JSON:

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

Verbleibendes Kontingent

GET /api/v1.0/account liefert die Kontostruktur von remove.bg. api.free_calls ist die Zahl der heute noch kostenlosen Bilder, credits.payg das Credit-Guthaben des Kontos und credits.total die Summe aus beidem.

Fehler

Fehler nutzen das unten gezeigte Format von remove.bg. Eine fehlgeschlagene Anfrage verbraucht kein Bild.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
StatusBedeutung
400Fehlerhafte Eingabe: kein Bild, zwei Bilder, eine unlesbare Datei, eine nicht unterstützte Option oder eine image_url, die wir nicht laden dürfen oder können.
403Der X-Api-Key-Header fehlt, ist falsch oder widerrufen.
422Das angeforderte Modell ist gerade nicht verfügbar (Code model_unavailable). Mit model=fast erneut versuchen; das Bild wird nicht gezählt.
429Die 50 kostenlosen Bilder für heute sind aufgebraucht und das Konto hat keine Credits mehr, oder es hat heute 1.000 bezahlte Bilder erreicht. Retry-After nennt die Sekunden bis zum Zurücksetzen der kostenlosen Bilder.
503Die Verarbeitung ist vorübergehend nicht verfügbar. Bitte kurz warten und erneut versuchen.

Grenzen

  • 50 Bilder pro Tag und Konto, geteilt von allen Schlüsseln. Bis zu 3 aktive Schlüssel pro Konto, damit du sie rotieren kannst.
  • Uploads bis 22 MB. Ausgabe bis 25 MP, bei PNG bis 10 MP.
  • Anfragen werden eingereiht und jeweils wenige gleichzeitig verarbeitet. Rechne mit einigen Sekunden pro Bild, bei großen Fotos mehr.
  • Nach den 50 kostenlosen Bildern kostet jedes Bild einen Credit vom Guthaben des Kontos, bis zu 1.000 bezahlte Bilder pro Tag. Credits werden auf der Kontoseite gekauft (100 für 5 US$ oder 500 für 19 US$) und verfallen nicht.

Was du von den Freistellungen erwarten kannst

Die Freistellungen stammen vom Modell isnet-general-use, dem gleichen wie im Hintergrundentferner. Bei Produkten, Menschen und Tieren vor normalen Hintergründen ist es zuverlässig. Schwächen hat es bei feinem Haar, Glas und Motiven in der Farbe des Hintergrunds; dort kann das Modell von remove.bg besser sein. Teste einige eigene Bilder, bevor du eine Produktionsstrecke umstellst.

Fragen

Ist das ein offizieller Ersatz für remove.bg?
Nein. Imagic AI ist nicht mit remove.bg, Canva oder Leonardo.Ai verbunden. Die API akzeptiert das Anfrageformat von remove.bg, damit bestehender Code weiter funktioniert.
Ist die API kostenlos?
Ja. Jedes Konto hat 50 Bilder pro Tag ohne Kosten. Jede Größe, auch preview, zählt als ein Bild. Darüber hinaus kostet jedes Bild einen Credit (100 Credits kosten 5 US$).
Funktionieren die offiziellen Client-Bibliotheken von remove.bg?
Bibliotheken mit einstellbarer Basis-URL funktionieren, wenn du sie auf https://imagic-ai.com/api änderst. Bei fest eingetragenem api.remove.bg musst du diese eine Zeile im Quellcode ändern oder einen kleinen Wrapper schreiben.
Speichert ihr meine Bilder?
An die API gesendete Bilder werden verarbeitet und in der Antwort zurückgegeben. Sie landen in keiner Galerie und werden nicht zum Training verwendet.

Nur ein paar Bilder, ohne Code?

Hintergrundentferner nutzen