API für die Hintergrundentfernung
Entfernt den Hintergrund aus einem Bild und liefert ein transparentes PNG. Kein API-Schlüssel. Kein Konto. Ein POST-Request mit einem Bild ist der gesamte Aufruf: Sie müssen sich nicht registrieren und auf nichts warten. Es handelt sich um eine kostenlose API, um den Hintergrund zu entfernen: ein API-Aufruf für hintergrund entfernen, der über curl, Python, Node oder alles andere funktioniert, was einen HTTP-POST senden kann.
Zuletzt aktualisiert: 28. September 2026
Dies ist dieselbe Engine, die BGNinja-Website läuft direkt über HTTP und ist öffentlich zugänglich. Die Nutzung ist innerhalb der unten genannten Grenzen kostenlos. Sie müssen uns nicht um Zugriff bitten, und es gibt keinen Schlüssel, den Sie regelmäßig ändern müssen.
Schnellstart
curl -s -o output.png \
-F "file=@input.jpg" \
https://bgninja.com/api/remove
Das ist alles. output.png Hierbei wird der Hintergrund aus Ihrem Bild entfernt und durch einen Alphakanal ersetzt.
Wechseln Sie von der remove.bg API?
Die API-Seite von remove.bg besagt, dass ab dem 1. Dezember 2026 die Hintergrundentfernung zu Leonardo.Ai wechselt. Wenn Sie sich lieber nicht woanders anmelden möchten, ist die Umstellung auf BGNinja gering:
| remove.bg | BGNinja | |
|---|---|---|
| URL | https://api.remove.bg/v1.0/removebg | https://bgninja.com/api/remove |
| Bildfeld | image_file | file |
| Hintergrundfarbe | bg_color | bg (6-stelliger Hex-Code, kein #; Farbnamen wie white werden ignoriert und ergeben Transparenz) |
| Authentifizierung | X-Api-Key Header | keiner, den Header weglassen |
| Ausgabegröße | size (Credits pro Größe) | Immer Ihre volle Auflösung, bis zu 30 MP |
| Antwort | PNG Bytes | PNG Bytes, gleiche Verarbeitung |
Zwei Unterschiede: Das kostenlose Limit beträgt hier 10 Bilder pro Tag und IP-Adresse, und es gibt keine Eingabe per Bild-URL. Senden Sie die Datei selbst. Wenn Sie große Mengen verarbeiten, teilen Sie uns dies auf der Kontaktseite zuerst. Für einzelne Fotos im Browser siehe das remove.bg Alternative Seite und was die Abschaltung von remove.bg bedeutet.
Endpunkt
| Methode | POST |
|---|---|
| URL | https://bgninja.com/api/remove |
| Körper | multipart/form-data |
| Authentifizierung | Keine |
Parameter
| Name | Erforderlich | Was es tut |
|---|---|---|
file | ja | Das Bild. PNG, JPG, WEBP oder HEIC. |
bg | nein | Hexadezimalfarbe ohne die #zum Beispiel ffffff. Fügt das ausgeschnittene Bild anstelle einer transparenten Fläche über eine einfarbige Fläche ein. Wenn Sie dies weglassen, bleibt das Bild transparent. |
src | nein | Eine Bezeichnung, mit der Sie Ihre App identifizieren können, zum Beispiel my-pluginBis zu 32 Zeichen, Buchstaben, Zahlen und Bindestriche. Dies dient lediglich dazu, dass wir erkennen können, welche Integrationen verwendet werden. Alles andere wird ignoriert. |
Antwort
Wenn alles geklappt hat, erhalten Sie HTTP 200 und die rohen Daten einer PNG-Datei, mit Content-Type: image/pngDie Anfrage erfolgt synchron: Es gibt keine Job-ID, keine Warteschlange und keine Möglichkeit, den Status abzufragen. Schreiben Sie den Inhalt direkt in eine Datei oder übergeben Sie ihn an Ihre Bildbibliothek.
Einschränkungen
| Maximale Dateigröße | 99 MB |
|---|---|
| Maximale Auflösung | 30 Megapixel |
| Gleichzeitig ausführen | 2 pro IP-Adresse |
| Anfragen pro Tag | 10 kostenlose Versuche, die Anzahl wird um Mitternacht zurückgesetzt |
Diese sind real und werden durchgesetzt. Es gibt keine versteckte, unbegrenzte Stufe, und das kostenlose Ergebnis ist das Bild in voller Auflösung und nicht nur eine verkleinerte Vorschau.
Fehler
Ein Fehler wird als JSON mit einem einzigen error Schlüssel, nicht als Bild. Überprüfen Sie den Statuscode, bevor Sie den Inhalt in eine Datei schreiben.
| Status | Bedeutung |
|---|---|
400 | Die Datei ist kein Bild, das wir lesen können. Falsches Format oder die Daten sind beschädigt. |
402 | Die 10 kostenlosen Anfragen für heute sind aufgebraucht. Die Zählung wird um Mitternacht zurückgesetzt. |
413 | Zu groß. Entweder über 99 MB oder mehr als 30 Megapixel. |
422 | Nein file Feld in der Anfrage überhaupt. Dieses hier kommt zurück unter einem detail Schlüssel anstelle von error. |
429 | Sie haben bereits zwei Anfragen von dieser Adresse laufen. Warten Sie, bis eine abgeschlossen ist, und versuchen Sie es erneut. |
$ curl -s -F "file=@notes.txt" https://bgninja.com/api/remove
{"error":"can't read this file (TXT), please upload a photo (JPG, PNG, WEBP, HEIC)."}
A 429 gibt an, wie viele gleichzeitig laufen, also versuchen Sie dasselbe Bild kurz danach erneut. Ein 402 ist die tägliche Zählung, daher hilft ein erneuter Versuch vor Mitternacht nicht.
Beispiele
Python
import requests
with open("input.jpg", "rb") as f:
r = requests.post(
"https://bgninja.com/api/remove",
files={"file": f},
data={"src": "my-app"},
timeout=120,
)
r.raise_for_status()
open("output.png", "wb").write(r.content)
Node
import { readFile, writeFile } from "node:fs/promises";
const body = new FormData();
body.append("file", new Blob([await readFile("input.jpg")]), "input.jpg");
body.append("src", "my-app");
const r = await fetch("https://bgninja.com/api/remove", { method: "POST", body });
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await writeFile("output.png", Buffer.from(await r.arrayBuffer()));
Ein einfarbiger, weißer Hintergrund anstelle von Transparenz.
curl -s -o output.png \
-F "file=@input.jpg" \
-F "bg=ffffff" \
https://bgninja.com/api/removeWas mit Ihrem Bild geschieht
Es wird im Speicher verarbeitet und direkt an Sie zurückgesendet. Nichts wird auf der Festplatte gespeichert, sodass es keine gespeicherte Kopie gibt, die irgendwo darauf wartet, gelöscht oder weitergegeben zu werden. Wir speichern lediglich die Anzahl der eingegangenen Anfragen und deren Größe sowie keine Informationen, die das Bild selbst identifizieren.
Verwendung in Ihrem eigenen Projekt
Sie können dies gerne erweitern, auch in Produkten, für die Sie eine Gebühr erheben. Eine Bedingung und eine Bitte:
- Bitte: Geben Sie ein
srcmit einem Label versehen, damit wir sehen können, dass eine Integration vorhanden ist, und vermeiden, dass diese unterbrochen wird. - Bedingung: Wenn Sie BGNinja auf einer Website oder in einer App verwenden, die andere Personen nutzen, nennen Sie uns („Hintergrund entfernen mit BGNinja“, mit Link zu bgninja.com) an einer Stelle, an der Nutzer es sehen können, wie zum Beispiel in der Fußzeile oder auf einer Seite mit Mitwirkenden. Dies ist der einzige Grund, warum wir dies kostenlos und ohne Key anbieten können. Die Nutzung mit Ihren eigenen Dateien erfordert keine Nennung.
Wenn Sie planen, große Datenmengen damit zu verarbeiten, melden Sie sich gerne unter Kontaktseite zuerst. Wir würden lieber von Ihnen hören, als Sie zu drosseln.
Fragen
Ist dies ein Ersatz für die remove.bg API?
Ja. Die API von remove.bg zieht am 1. Dezember 2026 zu Leonardo.Ai um. Hier ändern Sie die URL zu https://bgninja.com/api/remove, benennen Sie image_file in file und bg_color in bg um und lassen Sie den X-Api-Key-Header weg. Das kostenlose Limit beträgt 10 Bilder pro Tag.
Benötige ich einen API-Schlüssel?
Nein. Es gibt keinen Schlüssel, kein Konto und keine Registrierung. Der Endpunkt ist öffentlich zugänglich.
Ist es wirklich kostenlos?
Ja, innerhalb der oben genannten Grenzen. Es handelt sich nicht um eine Testversion, und es ist keine Kreditkarte erforderlich. Die optionale Pass erhöht die Nutzungslimits auf der Website; die hier aufgeführten API-Limits gelten für alle Benutzer.
Gibt es eine tägliche Beschränkung der Anfragen?
Im kostenlosen Tarif sind 10 Anfragen pro Tag möglich, wobei das Limit jeden Tag um Mitternacht zurückgesetzt wird. Die einzige weitere Einschränkung ist, dass pro IP-Adresse maximal zwei Anfragen gleichzeitig laufen dürfen.
Kann ich die Maske anstelle des Bildes erhalten?
Nicht heute. Der Endpunkt gibt die zusammengesetzte PNG-Datei zurück. Wenn Sie die Maske separat benötigen, teilen Sie uns dies bitte mit Kontaktseite und wir werden uns das ansehen.
Wird dieser Endpunkt weiterhin funktionieren?
Es ist derselbe Endpunkt, den auch unsere eigene Website verwendet, sodass er nicht einfach verschwinden wird. Wenn sich das Format der Anfrage jemals ändern muss, wird die alte Form weiterhin parallel dazu funktionieren.
Ist die Antwort asynchron?
Nein. Der Aufruf ist synchron, der HTTP-Antworttext ist das fertige PNG-Bild. Es gibt keine Job-ID und nichts, was abgefragt werden müsste.
Welche Bildformate werden akzeptiert?
PNG-, JPG-, WEBP- und HEIC-Dateien werden eingegeben. Eine PNG-Datei mit einem Alphakanal wird ausgegeben, oder ein einfarbiger Hintergrund, wenn Sie eine Hexadezimalfarbe im Parameter „bg“ angeben.
Was passiert mit dem Bild, das ich sende?
Es wird im Speicher verarbeitet und direkt zurückgestreamt. Nichts wird auf der Festplatte gespeichert, sodass es keine gespeicherte Kopie zum Löschen gibt.
Was passiert, wenn ich zu viele Anfragen sende?
Eine dritte gleichzeitig laufende Anfrage von einer IP-Adresse erhält HTTP 429: Warten Sie, bis eine abgeschlossen ist, und versuchen Sie es erneut. Nach 10 Anfragen an einem Tag erhalten Sie bis Mitternacht HTTP 402.
Die Nutzungsbedingungen finden Sie unter AGB, und was wir mit Daten machen, ist auf der Datenschutzseite.