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:
| Vorher | https://api.remove.bg/v1.0/removebg |
|---|---|
| Nachher | https://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.
Schlüssel holen
- Mit Google anmelden.
- Mein Konto öffnen und unter „API-Schlüssel zum Freistellen“ einen Schlüssel erstellen.
- Den Schlüssel kopieren, sobald er erscheint. Er wird nur einmal angezeigt.
Schnellstart
Sende das Bild als Datei-Upload, als Base64 oder als öffentliche URL. Der Antwortinhalt ist das fertige Bild.
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/removebgimport 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()));Anfragefelder
POST /api/v1.0/removebg akzeptiert multipart/form-data, application/x-www-form-urlencoded oder JSON. Sende genau eines der drei Bildfelder.
| Feld | Werte | Hinweise |
|---|---|---|
| image_file | Datei | JPG, PNG oder WebP bis 22 MB. |
| image_file_b64 | Base64-String | Dieselbe Datei als Base64. Ein data:-URL-Präfix wird akzeptiert. |
| image_url | http(s)-URL | Wir laden sie herunter. Nur öffentliche Adressen und Standard-Webports, bis zu 3 Weiterleitungen. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/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. |
| format | auto · png · jpg · webp · zip | auto liefert PNG, wenn das Ergebnis transparent ist, sonst JPG. zip enthält color.jpg und alpha.png wie bei remove.bg. |
| channels | rgba · alpha | alpha liefert nur die Maske in Graustufen. |
| bg_color | Hex (81d4fa, #81d4fa77) oder Farbname | Füllt den entfernten Hintergrund. Ein JPG ohne bg_color wird auf Weiß gelegt. |
| crop | true · false | Schneidet das Ergebnis auf das Motiv zu. |
| crop_margin | z. B. 30px oder 10% | Rand um das zugeschnittene Motiv. Bis 500px oder 50%. |
| type | auto · person · product · car · animal · graphic · transportation | Aus Kompatibilitätsgründen akzeptiert. Wird in X-Type zurückgegeben, ändert die Freistellung nicht. |
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. Mit Accept: application/json gibt es stattdessen 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. credits.total und api.free_calls sind beide die Zahl der heute noch verfügbaren Bilder.
Fehler
Fehler nutzen das unten gezeigte Format von remove.bg. Eine fehlgeschlagene Anfrage verbraucht kein Bild.
{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}| Status | Bedeutung |
|---|---|
| 400 | Fehlerhafte 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. |
| 403 | Der X-Api-Key-Header fehlt, ist falsch oder widerrufen. |
| 429 | Die 50 Bilder für heute sind aufgebraucht. Retry-After nennt die Sekunden bis zum Zurücksetzen. |
| 503 | Die 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.
- Einen kostenpflichtigen Tarif gibt es noch nicht; das Tageskontingent ist vorerst die Obergrenze.
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.
- 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