← Zurück zum Tool

API für die Hintergrundentfernung

Kein API Key. Kein Konto. Keine Anmeldung. Ein POST mit einem Bild und der Response Body ist das fertige transparente PNG. Nichts zu registrieren und nichts zu warten.

Zuletzt aktualisiert: 1. September 2026

Dies ist der gleiche Motor BGNinja Website läuft weiter, direkt über HTTP ausgesetzt. Es ist frei, innerhalb der folgenden grenzen anzurufen. Sie müssen uns nicht um Zugang bitten und es gibt keinen Schlüssel zum Drehen.

Schnellstart

curl -s -o output.png \
  -F "[email protected]" \
  https://bgninja.com/api/remove

Das ist die ganze Sache. output.png ist Ihr Bild mit dem Hintergrund entfernt und einem Alpha-Kanal, wo der Hintergrund früher war.

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	Hexfarbe ohne das #z.B. ffffffKomponiert den Ausschnitt auf diese flache Farbe, anstatt ihn transparent zu lassen. Lassen Sie es für Transparenz aus.
src	nein	Ein Label, das Ihre App identifiziert, zum Beispiel my-pluginBis zu 32 Zeichen, Buchstaben, Ziffern und Bindestriche. Es hilft uns nur zu sehen, welche Integrationen verwendet werden. Alles andere wird ignoriert.

Antwort

Auf Erfolg erhalten Sie HTTP 200 und die Rohbytes eines PNG, mit Content-Type: image/pngDer Anruf ist synchron: Es gibt keine Job-ID, keine Warteschlange und nichts zu wählen. Schreiben Sie den Körper direkt in eine Datei oder geben 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 frei, Resets um Mitternacht

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 kommt als JSON mit einer einzigen error Schlüssel, nicht als Bild. Überprüfen Sie den Statuscode, bevor Sie den Körper 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.
413	Zu groß. Entweder über 99 MB oder mehr als 30 Megapixel.
422	Nein file überhaupt in der Anfrage angeben.
429	Sie haben bereits zwei Anfragen von dieser Adresse laufen. Warten Sie, bis eine abgeschlossen ist, und versuchen Sie es erneut.

$ curl -s -F "[email protected]" https://bgninja.com/api/remove
{"error":"can't read this file (TXT) — please upload a photo (JPG, PNG, WEBP, HEIC)."}

Da die Grenze ist, wie viele auf einmal laufen und nicht auf einer täglichen Gesamt, der richtige Weg zu handhaben 429 ist, das gleiche Bild kurz danach zu wiederholen, nicht für den Rest des Tages zurückzuweichen.

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 "[email protected]" \
  -F "bg=ffffff" \
  https://bgninja.com/api/remove

Was 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 weiterentwickeln, auch in einem Projekt, für das Sie eine Gebühr erheben. Wir haben zwei Wünsche, die wir aber nicht erzwingen:

• Pass a src Beschriften, damit wir sehen können, dass eine Integration existiert und vermeiden, sie zu brechen.
• Wenn Ihr Projekt eine Seite hat, die auflistet, was es verwendet, ein Link zurück zu bgninja.com Hilft mehr, als Sie denken. Es ist der ganze Grund, warum wir dies frei und unmetered halten können.

Wenn Sie im Begriff sind, ernsthafte Volumen durch sie zu senden, sagen Hallo auf der Kontaktseite zuerst. Wir würden lieber von Ihnen hören, als Sie zu drosseln.

Fragen

Nutzungsbedingungen sind auf der Begriffe Seiteund was wir mit Daten machen, ist auf der Datenschutzseite.