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.

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.

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:

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. 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"}]}
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.
429Die 50 Bilder für heute sind aufgebraucht. Retry-After nennt die Sekunden bis zum Zurücksetzen.
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.
  • 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