Die API von remove.bg wird eingestellt. Eine Zeile ändern, Code behalten.
Die eigenständige Website und die Self-Service-API von remove.bg enden am . Die API wechselt zu Leonardo.Ai (ein Canva-Unternehmen), was Änderungen an deiner Integration erfordert (Ankündigung von Leonardo.Ai). removebackground.dev akzeptiert dieselben Anfragen: Richte deinen Code auf unsere URL, nutze unseren Schlüssel – fertig.
Die Self-Service-API von remove.bg endet am
Die eine Zeile, die sich ändert
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgDerselbe X-Api-Key-Header, mit deinem removebackground.dev-Schlüssel. Gleiche Parameternamen, gleiche Antwort-Header, gleiches {"errors": [...]}-Fehlerformat.
Vorher und nachher
Eine typische Integration in vier Sprachen. Der Schlüssel kommt aus REMOVEBG_API_KEY, die einzige Änderung ist also die hervorgehobene URL.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Du nutzt Zapier, Make oder n8n?
Öffne den HTTP-Request-Schritt, der remove.bg aufruft (Zapier Webhooks, Make HTTP, n8n HTTP Request), ändere die URL auf https://removebackground.dev/v1.0/removebg und den Wert von X-Api-Key auf deinen removebackground.dev-Schlüssel. Alle anderen Felder bleiben, wie sie sind.
Parameter-Kompatibilität
Alles, was deine remove.bg-Anfrage sendet, wird akzeptiert. Einige Optionen haben hier keine Wirkung – das steht unten dabei.
| Parameter | Status | Hinweise |
|---|---|---|
image_file / image_file_b64 / image_url | Unterstützt | Multipart-, urlencoded- oder JSON-Body. JPG, PNG oder WebP bis 25 MB. |
size | Unterstützt | auto, full, 4k und 50MP liefern die Originalauflösung (bis 25 MP); preview, small und regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Immer 1 Credit. |
format | Unterstützt | auto (PNG bei Transparenz, sonst JPG), png, jpg, webp und zip (color.jpg + alpha.png). |
crop / crop_margin | Unterstützt | px oder % des Motivs, 1–4 Werte im CSS-Stil („10% 20%“ = vertikal, horizontal); höchstens 500px oder 50% pro Seite. |
roi | Unterstützt | „x1 y1 x2 y2“ in px oder %: Nur das Motiv innerhalb des Bereichs bleibt erhalten. |
scale / position | Unterstützt | scale 10%–100% oder original; position center, original oder „x% y%“. |
channels | Unterstützt | rgba (Freisteller) oder alpha (Graustufenmaske). |
bg_color | Unterstützt | Hex mit oder ohne # (81d4fa) oder ein Farbname. Bei 8-stelligem Hex bleibt die Farbe erhalten, der Alphawert entfällt. |
bg_image_url / bg_image_file | Unterstützt | Der Freisteller wird über dein Hintergrundbild gelegt, das per cover auf die Ausgabegröße eingepasst wird. |
Accept: application/json | Unterstützt | Liefert { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Akzeptiert, ignoriert | Das Motiv wird automatisch erkannt; X-Type ist immer „other“. |
semitransparency | Akzeptiert, ignoriert | Weiche Kanten und halbtransparente Bereiche kommen unverändert aus der Maske des Modells. |
shadow_type / shadow_opacity / add_shadow | Akzeptiert, ignoriert | Es werden keine Schatten hinzugefügt. |
Lang laufende Anfragen | Abweichung | Wir warten bis zu 110 Sekunden; ist ein Bild bis dahin nicht fertig, bekommst du einen wiederholbaren 503 (keine Kosten, außer es wurde fertig). |
Antwort-Header
Ein erfolgreicher Aufruf antwortet mit den Bild-Bytes (image/png, image/jpeg, image/webp oder application/zip) und diesen Headern. Sende Accept: application/json, um stattdessen result_b64 zu erhalten.
| Header | Bedeutung |
|---|---|
X-Width / X-Height | Größe des Ergebnisses in Pixeln. |
X-Credits-Charged | Von diesem Bild verbrauchte Credits: immer 1 (fehlgeschlagene Bilder kosten 0). |
X-Type | Immer „other“ (die Motiverkennung ist automatisch). |
X-Foreground-Top / -Left / -Width / -Height | Begrenzungsrahmen des Motivs im Ergebnis, in Pixeln. |
X-Request-ID | Gibt deine X-Request-ID zurück oder eine generierte ID. Zusätzlich. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Wie sauber die Maske ist (0–1) und der Anteil weicher Pixel. Zusätzlich: nützlich, um Bilder zur Prüfung zu markieren. |
Fehler
| Status | Bedeutung |
|---|---|
400 | Ungültiger Parameter oder ungültiges Bild (Codes wie invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: Lade auf der Preisseite auf. |
403 | auth_failed: X-Api-Key fehlt oder ist ungültig. |
429 | rate_limit_exceeded. |
500 / 503 | Verarbeitung fehlgeschlagen, Zeitüberschreitung oder der Dienst ist kurz nicht verfügbar. Erneut versuchen; fehlgeschlagene Bilder sind kostenlos. |
Prüfe dein Guthaben mit GET https://removebackground.dev/v1.0/account: Die Antwort hat das Kontoformat von remove.bg. Alle Details in der API-Referenz.
Credits: 1 pro Bild, und sie verfallen nie
Jedes erfolgreiche Bild kostet 1 Credit, unabhängig von Größe oder Optionen. Fehlgeschlagene Bilder sind kostenlos. Neue Konten erhalten 50 kostenlose Credits zum Testen.
- Credits verfallen nieEinmal aufladen, nächste Woche oder nächstes Jahr nutzen.
- Kein AboEinmalige Pakete. Nichts verlängert sich.
- Fehlgeschlagene Bilder sind kostenlosEin Credit wird nur verbraucht, wenn der Hintergrund entfernt wurde.
Migrations-Checkliste
- removebackground.dev-API-Schlüssel holenRegistriere dich (50 kostenlose Credits) und erstelle auf deiner Kontoseite einen Schlüssel.
- Eine Zeile ändernRichte deinen Code auf https://removebackground.dev/v1.0/removebg und setze den neuen Schlüssel in denselben X-Api-Key-Header.
- Ein Bild testenSende eine echte Anfrage und vergleiche das Ergebnis mit dem, was du heute bekommst.
- Traffic umstellenDeploye vor dem 1. Dezember 2026 um 09:00 CET. Lade einmal Credits auf; sie verfallen nie.
FAQ zur Migration von remove.bg
Wird remove.bg eingestellt?
Die eigenständige Website und die Self-Service-API von remove.bg enden am 1. Dezember 2026 um 09:00 CET. Die API wechselt zu Leonardo.Ai (ein Canva-Unternehmen), was Änderungen an deiner Integration erfordert. Quelle: Ankündigung von Leonardo.Ai unter https://www.leonardo.ai/news/removebg-api-leonardo.
Was ist der einfachste Ersatz für die remove.bg-API?
removebackground.dev hat einen remove.bg-kompatiblen Endpunkt. Ändere https://api.remove.bg/v1.0/removebg in https://removebackground.dev/v1.0/removebg, sende einen removebackground.dev-Schlüssel im selben X-Api-Key-Header und behalte den Rest deines Codes: Parameternamen, Antwort-Header und Fehlerformat stimmen überein.
Muss ich meine Integration vor Dezember 2026 neu schreiben?
Nein. Anfragen behalten dieselben Parameter (image_file, image_url, size, format, crop, bg_color …) und erhalten dieselbe Art von Antwort: die Bild-Bytes mit den Headern X-Width, X-Height und X-Foreground-* oder JSON mit result_b64. Nur URL und Schlüssel ändern sich.
Funktioniert das mit Zapier, Make oder n8n?
Ja. Ändere in deinem HTTP-Request-Schritt (Zapier Webhooks, Make HTTP, n8n HTTP Request) die URL auf https://removebackground.dev/v1.0/removebg und den Wert von X-Api-Key auf deinen removebackground.dev-Schlüssel. Sonst ändert sich nichts.
Was kostet das?
1 Credit pro erfolgreichem Bild, unabhängig von Größe oder Optionen. Kein Abo: einmalige Aufladungen für 17 $, 49 $ oder 99 $, und Credits verfallen nie. Fehlgeschlagene Bilder sind kostenlos. Neue Konten erhalten 50 kostenlose Credits.
Welche remove.bg-Parameter werden unterstützt?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url und bg_image_file. type, type_level, semitransparency und die shadow-Optionen werden akzeptiert und ignoriert, Anfragen, die sie senden, funktionieren also weiterhin.
Kann ich mein Guthaben wie bisher abfragen?
Ja. GET https://removebackground.dev/v1.0/account mit deinem Schlüssel liefert deine Credits im Kontoformat von remove.bg.
Ist removebackground.dev mit remove.bg verbunden?
Nein. remove.bg ist eine Marke ihres Inhabers. removebackground.dev ist ein unabhängiger Dienst, der dieselben API-Anfragen akzeptiert.
Wechsle vor dem 1. Dezember 2026 um 09:00 CET
Die Self-Service-API von remove.bg endet am
Schlüssel erstellen, eine Zeile ändern, ein Bild testen. 50 kostenlose Credits inklusive.
remove.bg ist eine Marke ihres Inhabers; removebackground.dev ist nicht mit ihr verbunden.