remove.bg API-Migrationsleitfaden

1

Zuerst lesen

Die vier Dinge, die nicht gleich sind.

size hat wie bei remove.bg den Standardwert preview — hier ist preview aber ein kostenloses Bild mit Wasserzeichen bis 640 px (remove.bg: 0,25 Megapixel ohne Wasserzeichen). Eine Integration, die size nie setzt, erhält Vorschauen mit Wasserzeichen; übergeben Sie size=auto oder eine kostenpflichtige Stufe für das Ergebnis ohne Wasserzeichen.
Wir behaupten keine Kompatibilität auf SDK-Ebene. Drei Drittanbieter-Clients — das PyPI-Paket removebg, das offizielle npm-Paket remove.bg und removebg-cli — haben unsere Tests am 22. September 2026 bestanden, aber wir testen sie nicht Release für Release auf Regressionen; der von uns unterstützte Weg sind selbst geschriebene HTTP-Clients.
shadow_type, shadow_opacity, add_shadow und semitransparency werden akzeptiert und validiert, ändern die Ausgabe aber nie — wie bei remove.bg für Motive außer Autos; ein autospezifisches Modell gibt es hier nicht.
Jeder Aufruf zählt als ein Bild gegen das Limit Ihres Schlüssels von 40 Bildern pro Minute — remove.bg erlaubt 500. Behandeln Sie 429 mit Retry-After oder kontaktieren Sie uns, um das Limit zu erhöhen.

2

Vorher und nachher

Dieselbe Anfrage an beide Dienste.

remove.bg

1curl -X POST "https://api.remove.bg/v1.0/removebg" \2  -H "X-Api-Key: REMOVEBG_KEY" \3  -F "[email protected]" \4  -F "size=auto" \5  -o out.png

PixMiller

1curl -X POST "https://api.pixmiller.com/v1.0/removebg" \2  -H "X-Api-Key: PIXMILLER_KEY" \3  -F "[email protected]" \4  -F "size=auto" \5  -o out.png6# 200 OK → image bytes, written straight to out.png7# X-Credits-Charged: 1   X-Width: 1200   X-Height: 1600   X-Type: product

3

Parameter-Unterstützung

Parameter	Status	Hinweise
`image_file`	Gleich	Multipart-Upload. JPG / PNG / WebP, bis zu 20 MB (remove.bg: 22 MB).
`image_url`	Gleich	Öffentlich erreichbare Bild-URL, die auf unserer Seite abgerufen wird, mit demselben Limit von 20 MB.
`image_file_b64`	Gleich	Base64-kodiertes Bild im Request-Body, genau wie bei remove.bg.
`size`	Anders	Dieselben Werte, dieselbe Standardeinstellung (preview) und dieselben Megapixel-Obergrenzen — aber preview ist hier ein kostenloses Bild mit Wasserzeichen bis 640 px, nicht 0,25 MP ohne Wasserzeichen. medium / hd / 4k / full / 50MP kosten je 1 Credit; auto nutzt die kostenpflichtige Stufe, solange Credits vorhanden sind.
`format`	Gleich	auto / png / jpg / webp / zip — zip enthält color.jpg und alpha.png wie bei remove.bg. Accept: application/json liefert den base64-Umschlag. Die PNG-Ausgabe ist auf 10 Megapixel begrenzt.
`type, type_level`	Anders	Wird akzeptiert; type wird auf unsere eigenen Modelle abgebildet. X-Type meldet eine grobe Klasse — person, product, animal, car oder other — und type_level=2 / latest liefern dieselben groben Klassen.
`crop, crop_margin`	Gleich	Schneidet auf das Motiv zu, mit derselben margin-Syntax und derselben Obergrenze von 50% / 500 px.
`roi`	Gleich	Region of Interest in Pixeln oder Prozent, wie bei remove.bg.
`scale, position`	Gleich	Skalierung des Motivs über scale (10%–100% oder original) und position, wie bei remove.bg.
`channels`	Gleich	rgba (Standard) oder alpha nur für die Maske.
`bg_color`	Gleich	Standardmäßig transparent; 3-, 4-, 6- oder 8-stelliger Hex-Wert mit oder ohne #, oder ein Farbname.
`bg_image_file, bg_image_url`	Gleich	Wird so skaliert, dass es die Ausgabe füllt, und zentriert; nicht mit bg_color kombinierbar.
`add_shadow, shadow_type, shadow_opacity`	Keine Wirkung	Wird gegen die Werte von remove.bg validiert, es wird aber nie ein Schatten gerendert.
`semitransparency`	Keine Wirkung	Wird akzeptiert; halbtransparente Bereiche werden immer automatisch behandelt.

Jeder Parameter wird mit den Wertebereichen von remove.bg selbst validiert, ein ungültiger Wert ergibt also 400 invalid_parameter, statt still ignoriert zu werden — genau so, wie remove.bg antwortet.

4

Was sich anders verhält

Statuscode 200 OK mit den Bildbytes, genau wie bei remove.bg — Code, der == 200 prüft, funktioniert weiter. (PixMillers eigener Endpunkt /api/v1/remove antwortet mit 201 und JSON; dieser Kompatibilitätspfad bewusst nicht.)

Response-Body Die Bildbytes, genau wie bei remove.bg. Senden Sie Accept: application/json, um stattdessen den base64-Umschlag von remove.bg zu erhalten, oder format=zip für color.jpg plus alpha.png.

Response headers X-Credits-Charged, X-Width, X-Height, X-Type, X-Foreground-Top / -Left / -Width / -Height sowie X-RateLimit-Limit / -Remaining / -Reset werden alle zurückgegeben. X-Type ist eine grobe Klasse (person / product / animal / car / other) statt des feineren Vokabulars von remove.bg.

Fehler Fehler verwenden die JSON:API-Struktur von remove.bg: {"errors":[{"title":"…","code":"…"}]} — ein Array, errors[0].title liest sich also genau wie bisher. Ein fehlender Schlüssel ergibt 403 auth_failed, ein falscher 403 invalid_api_key, ein leeres Guthaben 402 und Drosselung 429.

Guthaben preview ist kostenlos; jede kostenpflichtige Stufe kostet 1 Credit pro Bild und wird erst berechnet, nachdem das Ergebnis abgeholt wurde — ein fehlgeschlagener Aufruf kostet also nie einen Credit. Es gibt kein monatliches Freikontingent.

Rate-Limit 40 Bilder pro Minute und Schlüssel (remove.bg: 500). Jeder Aufruf zählt als ein Bild, und X-RateLimit-Limit / -Remaining / -Reset geben dieses Kontingent pro Bild an; behandeln Sie 429 mit Retry-After.

5

Guthaben prüfen

Der account-Endpunkt meldet das verbleibende Credit-Guthaben des Schlüssels unter data.attributes.credits; eine gegen remove.bg geschriebene Guthabenprüfung behält also ihre Form. Es gibt kein monatliches Freikontingent, free_calls ist daher immer 0.

GET /v1.0/account

1curl "https://api.pixmiller.com/v1.0/account" \2  -H "X-Api-Key: PIXMILLER_KEY"

6

Fehler

400 invalid_parameter Ein Wert außerhalb des von remove.bg zugelassenen Bereichs für size / format / crop / scale / … oder eine fehlende Bildquelle; title nennt den betroffenen Parameter.

400 file_too_large Das Eingabebild überschreitet 20 MB.

400 unknown_foreground Im Bild konnte kein Vordergrund gefunden werden.

402 insufficient_credits Eine kostenpflichtige Stufe wurde angefordert, aber das Guthaben ist leer. Es wird nichts berechnet.

403 auth_failed / invalid_api_key Der X-Api-Key-Header fehlt (auth_failed) oder ist falsch (invalid_api_key) — 403 wie bei remove.bg, nicht 401.

429 rate_limit_exceeded Rate-Limit überschritten. Wiederholen Sie die Anfrage nach dem Retry-After-Header.

502 result_fetch_failed Das Ergebnis konnte nicht aus dem Speicher geholt werden. Es wurde nichts berechnet — wiederholen Sie die Anfrage.

Die Bedeutung steckt im Statuscode, und code verwendet das Vokabular von remove.bg selbst — ein switch auf errors[0].code funktioniert weiter.

remove.bg Alternative Kontaktieren Sie uns