Eine vertraute HTTP-Anfrage ist der Anfang. Teste Bilder und Integration mit dieser Checkliste, bevor du Produktionstraffic umstellst.
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
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'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.
Dieser Dienst ist unabhängig von remove.bg. Teste das Verhalten, nicht nur Parameternamen.