Eine vertraute HTTP-Anfrage ist der Anfang. Teste Bilder und Integration mit dieser Checkliste, bevor du Produktionstraffic umstellst.
Unsere Produktions-API ist auf Cloudflare live. D1 reserviert Credits atomar, privates R2 speichert Ergebnisse für Wiederholungen und Cloudflare Images läuft nur bei angeforderter Nachbearbeitung.
Checkliste für die Migration
1. Bisherige Anfragen prüfen
Notiere Eingabemethode, Ausgabeformat, Größe und Bearbeitungsparameter. Dateien, HTTPS-URLs und normales Base64 werden unterstützt, aber nicht jede remove.bg-Option. Halte Schlüssel auf dem Server und erstelle einen neuen Schlüssel in einem API-fähigen Tarif.
2. Endpunkt und Schlüssel ersetzen
Bei unterstützten HTTP-Anfragen bleiben Aufbau und Pfad gleich; ändere Origin und X-API-Key. Bei fest eingebautem remove.bg-Hostnamen brauchst du einen konfigurierbaren Endpunkt oder einen direkten HTTP-Aufruf. Sende keinen remove.bg-Schlüssel an diesen Dienst.
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
# Generate one ID per image; reuse it when retrying this request.
REQUEST_ID="$(uuidgen)"
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-H "Idempotency-Key: $REQUEST_ID" \
-F 'image_file=@image.jpg' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. Parameter vor dem Test abgleichen
Kompatibilität betrifft die unterstützte Anfrageform, nicht identische Freisteller. type muss auto, type_level none und channels rgba sein. Nicht leere, unzulässige Parameter werden abgelehnt, nicht still ignoriert.
| Anfragefeld | Hier unterstützt |
|---|---|
| image_file / image_url / image_file_b64 | Genau eine Quelle: image_file, image_url oder image_file_b64. |
| format | auto, png, jpg oder webp. ZIP wird nicht unterstützt. |
| size | Pixelgrenzen hängen vom Format ab. Prüfe Größentabelle und Ausgabegrenzen. |
| crop / bg_color | crop=true/false und bg_color werden unterstützt. |
| type / type_level / channels | Jeweils nur auto / none / rgba. |
| bg_image_url / shadow / roi / crop_margin / scale / position | Nicht unterstützt: Hintergrundbilder, Schatten, ROI, Beschnittränder, Skalierung oder Position. |
4. Antworten und Abrechnung prüfen
Prüfe Content-Type vor dem Speichern. Standardmäßig kommen Bildbytes, auf Wunsch JSON mit result_b64. Kontrolliere X-Credits-Charged und X-Request-ID. Credits gehören zu diesem Konto; remove.bg-Schlüssel und -Guthaben sind nicht übertragbar. Vorschau und volle Auflösung haben hier dieselbe Bildgebühr.
5. Repräsentative Testbilder verarbeiten
Teste Produkte, Porträts, kontrastarme Kanten und jedes Format ebenso wie zu große Dateien, ungültige Schlüssel, unzulässige Parameter und zu wenig Credits. Prüfe 409, 429, Zeitlimits und Verarbeitungsfehler. Bewahre Anfrage-IDs zur Fehlersuche auf.
Optionaler Idempotency-Key: Gleicher Schlüssel, gleiches Bild und gleiche Parameter liefern ein erfolgreiches Ergebnis 10 Minuten lang ohne neue Gebühr erneut. Der Replay wiederholt X-Credits-Charged und ergänzt X-Idempotent-Replayed: true. Laufende Anfragen liefern 409. Fehlgeschlagene/abgelaufene Schlüssel bleiben reserviert; eine neue kostenpflichtige Anfrage braucht einen neuen Schlüssel. Ohne Header ist jede Anfrage unabhängig. Plane 180 Sekunden Client-Timeout ein.
6. Schrittweise umstellen und Rückfallweg behalten
Leite zunächst einen kleinen Teil deiner eigenen Aufgaben an die neue Integration. Prüfe Erfolgsquote, Bildqualität und Credits; erhöhe erst danach den Anteil. Halte die bisherige Konfiguration bereit. Verteilung und Rollback steuert deine Anwendung, nicht ein automatischer Schalter dieses Dienstes.
Häufige Fragen zur Hintergrundentfernung
Ist dies ein direkter Ersatz für die remove.bg API?
Nein. RemoveBG akzeptiert image_file, image_url oder image_file_b64, aber Standardwerte und unterstützte Bearbeitungsparameter unterscheiden sich. Prüfe jedes Feld und die Antwort.
Kann ich meinen remove.bg API-Schlüssel wiederverwenden?
Nein. Erstelle ein RemoveBG-Konto und einen eigenen Schlüssel unter API Keys. Alte Konten, Guthaben und Schlüssel werden nicht importiert.
Kann ich jetzt kostenpflichtigen HD-API-Traffic senden?
Ja. Die Produktions-API ist live. Erstelle einen RemoveBG-API-Schlüssel, teste unterstützte Parameter und Ausgaben und stelle den Traffic dann schrittweise um.
RemoveBG ist ein unabhängiger Dienst und nicht mit remove.bg, Canva oder Leonardo.Ai verbunden. Bestehende Konten, Credits und API-Schlüssel werden nicht übertragen.