1 Credit pro Aufruf
Hintergrundentfernungs-API
Entfernen Sie Bildhintergründe programmatisch mit einer einzigen POST-Anfrage. Ein API-Schlüssel, transparentes PNG als Ausgabe und ein zustandsloser Dienst, der die gesendeten Bilder nie speichert.
- REST · JSON
- Kein Wasserzeichen
- Nichts wird gespeichert
POST /v1/remove-background
Was ist die Hintergrundentfernungs-API?
Die ImgGen AI Hintergrundentfernungs-API ist ein REST-Endpunkt, der das Motiv im Vordergrund vom Hintergrund eines Fotos trennt und ein transparentes PNG zurückgibt. Sie laden ein Bild per HTTPS hoch, die KI erkennt das Motiv automatisch, und der Freisteller kommt base64-kodiert in der JSON-Antwort zurück. Eine Maske oder manuelle Auswahl ist nicht nötig.
Es ist einer von sieben Endpunkten der ImgGen AI Bildbearbeitungs-API, die alle denselben API-Schlüssel, dieselbe Basis-URL und dasselbe Anfrage- und Antwortformat teilen. Wenn Sie diese Funktion auch im Browser statt aus dem Code heraus brauchen: Dasselbe KI-Modell treibt das Tool Background Remover an.
Anfrageparameter
Senden Sie eine POST-Anfrage an https://app.imggen.ai/v1/remove-background, authentifiziert mit einem API-Schlüssel im Authorization-Header.
| Parameter | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| image | file | PFLICHT | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Wie integriere ich die Hintergrundentfernungs-API?
Erstellen Sie in Ihrem ImgGen-Konto einen API-Schlüssel, hinterlegen Sie ihn als Umgebungsvariable und rufen Sie den Endpunkt auf. Hier ist dieselbe Anfrage in cURL, Node.js und Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Antwort
Ein erfolgreicher Aufruf gibt JSON zurück. Das Ergebnis ist base64-kodiert — dekodieren Sie es, bevor Sie es auf die Platte oder in Ihren Objektspeicher schreiben. Jede erfolgreiche Antwort trägt außerdem einen X-Credit-Remaining-Header mit Ihrem Guthaben nach dem Aufruf.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Limits und Verhalten, das Sie kennen sollten
Der Endpunkt akzeptiert JPEG (JPG), PNG und WebP mit maximal 25 MB Dateigröße und antwortet synchron innerhalb von 60 Sekunden — es gibt keinen Job abzufragen und keinen Webhook einzurichten.
Transparentes PNG als Ausgabe
Das Ergebnis wird mit einem echten Alphakanal zurückgegeben — Sie können es ohne zweite Anfrage auf jeden Hintergrund, jede Farbe oder Vorlage montieren.
Keine Maske nötig
Die Motiverkennung läuft automatisch — der Vordergrund wird für Sie vom Hintergrund getrennt. Es gibt nichts zu übermalen, nachzuzeichnen oder als zweiten Parameter zu übergeben: Eingabebild senden, Ergebnis lesen.
Nichts wird gespeichert
Die Eingabe liegt für die Dauer des Aufrufs in einem temporären Objekt und wird danach gelöscht. Praktisch, wenn Sie Kundenfotos verarbeiten, die Sie nicht aufbewahren dürfen.
Wofür wird die Hintergrundentfernungs-API eingesetzt?
Wo Teams diesen Endpunkt produktiv einsetzen, um Bilder programmatisch und in großem Umfang zu verarbeiten.
E-Commerce-Kataloge
Entfernen Sie Hintergründe von Lieferanten-Produktbildern schon beim Upload, damit jedes Angebot einen sauberen, einheitlichen Freisteller zeigt — ohne manuellen Bearbeitungsschritt.
Marktplätze und Kleinanzeigen
Vereinheitlichen Sie von Verkäufern hochgeladene Fotos automatisch. Schicken Sie jeden Upload durch den Endpunkt und legen Sie das transparente PNG neben dem Original ab.
Print-on-Demand
Stellen Sie Artwork und Motive frei, bevor Sie sie auf Mockups montieren, damit Vorschauen in jeder Produktgröße korrekt rendern.
Design- und Editor-SaaS
Geben Sie Ihren Nutzerinnen und Nutzern Hintergrundentfernung per Klick in Ihrem eigenen Produkt — ohne ein Modell zu trainieren, zu hosten oder eigene Inferenz auf AWS oder anderswo zu betreiben.
Was kostet die Hintergrundentfernungs-API?
Jeder erfolgreiche Aufruf kostet 1 Credit, Ihre effektiven Kosten pro Bild richten sich also nach Ihrem Tarif. Die Credits stammen aus Ihrem Tarif und gelten für alle Endpunkte und den Web-Editor gemeinsam — Sie kaufen kein getrenntes Kontingent pro Tool. Ein fehlgeschlagener Aufruf wird automatisch erstattet. Alle Details auf der Preisseite.
| Tarif | Preis | Credits | API |
|---|---|---|---|
| Free | $0 | 50 einmalige Gratis-Credits | Kein API-Zugang |
| Starter | $9.99 / month | 400 Credits / Monat | API-Zugang enthalten |
| Pro | $29.99 / month | 1.400 Credits / Monat | API-Zugang + priorisierter Support |
| Enterprise | Custom | Individuelles Volumen | Dedizierte Infrastruktur |
Credit-Kosten und Limits zuletzt geprüft am 2026-08-27.
Verwandte Endpunkte und Tools
Teams, die die Hintergrundentfernungs-API nutzen, greifen als Nächstes meist zu diesen.
Ebenfalls verfügbar: Hochskalierung, Fotorestaurierung, Fotokolorierung, Bildgenerierung.
FAQ zur Hintergrundentfernungs-API
- Es ist ein HTTP-Endpunkt, der ein Foto entgegennimmt und dasselbe Foto mit entferntem Hintergrund und dem Motiv auf einer transparenten Ebene zurückgibt. Weil es eine API und kein Editor ist, können Sie sie aus einem Backend-Job, einem Queue-Worker oder Ihrem Upload-Handler aufrufen und Tausende Bilder verarbeiten, ohne dass jemand einen Browser öffnet.
- Erzeugen Sie in Ihrem ImgGen-Konto einen API-Schlüssel und senden Sie dann per POST ein Multipart-Formular mit einem image-Feld an https://app.imggen.ai/v1/remove-background mit einem Authorization: Bearer-Header. Die Antwort ist JSON; dekodieren Sie das base64-Feld image und schreiben Sie es auf die Platte oder in Ihren Objektspeicher. Lauffähige Beispiele in cURL, Node.js und Python finden Sie auf dieser Seite.
- Ein Credit pro erfolgreichem Aufruf — der günstigste Endpunkt der API. Starter enthält 400 Credits im Monat für 9,99 $, also rund 400 Hintergrundentfernungen, und Pro enthält 1.400 für 29,99 $. Nicht genutzte Credits werden übertragen, solange Ihr Abo aktiv ist, und fehlgeschlagene Aufrufe werden automatisch erstattet — berechnet werden Ihnen also nur Bilder, die zurückkommen.
- Sie können ein Konto anlegen und die KI-Tools mit 50 kostenlosen Credits ohne Kreditkarte ausprobieren. Der API-Zugang gehört zu den kostenpflichtigen Tarifen Starter und Pro; eine dauerhaft kostenlose API-Stufe gibt es nicht, und wir sagen das lieber offen, als eine anzukündigen, die Sie dann still drosselt.
- Die API akzeptiert JPEG- (JPG), PNG- und WebP-Dateien bis 25 MB pro Bild. Die Ergebnisse werden als base64-kodiertes Bild in der JSON-Antwort zurückgegeben.
- Nein. Die API ist zustandslos: Sie legt kein Projekt an, speichert keine Datei und behält Ihr Bild nicht. Ihr Upload wird in ein temporäres Objekt geschrieben, verarbeitet und gelöscht, sobald die Antwort zurückgegeben wurde. Erhalten bleibt nur ein Nutzungsprotokoll, das festhält, dass ein Aufruf stattgefunden hat und wie viele Credits er gekostet hat. Ihre Bilder werden nie zum Trainieren von Modellen verwendet.
- Ja. Alle Tarife, auch der kostenlose, enthalten vollständige kommerzielle Nutzungsrechte, und kein Ergebnis trägt ein Wasserzeichen. Sie dürfen alles, was die API zurückgibt, verkaufen, drucken oder veröffentlichen.
- Der Endpunkt gibt ein transparentes PNG zurück — eine neue Farbe, einen Verlauf oder eine Kulisse montieren Sie also in Ihrer eigenen Pipeline, ohne zweiten API-Aufruf. Der ImgGen Web-Editor hat außerdem einen Hintergrundgenerator, falls Sie KI-erzeugte Kulissen statt eigener Assets möchten.
Loslegen
Rufen Sie die Hintergrundentfernungs-API auf
Ein Schlüssel schaltet alle sieben Endpunkte frei. Kein Wasserzeichen, vollständige kommerzielle Rechte, und nichts von dem, was Sie senden, wird nach der Antwort gespeichert.
API-Schlüssel holen