API-Referenz für die Hintergrundentfernung

Informiere dich über Anfrageparameter, Antwortformate und Unterschiede zur remove.bg API. Nutze Beispiele für Datei-, URL- und Base64-Eingaben und prüfe die jeweiligen Grenzen.

POST https://removebgtool.net/v1.0/removebg

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.png

Anfrage

Sende X-API-Key. image_file benötigt multipart/form-data; JSON oder URL-kodierte Daten unterstützen image_url und image_file_b64. Gib genau eine Bildquelle an. crop ist standardmäßig false, format ist auto (PNG bei Transparenz, JPG bei deckender Ausgabe). bg_color akzeptiert CSS-Farbnamen oder Hex mit 3/4/6/8 Stellen. JPG setzt transparente Bereiche auf Weiß.

curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F 'image_url=https://example.com/photo.jpg' \
  -F 'format=png' \
  'https://removebgtool.net/v1.0/removebg' -o result.png

# JSON input and JSON output
curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data '{"image_file_b64":"YOUR_PADDED_BASE64","format":"png"}' \
  'https://removebgtool.net/v1.0/removebg'

import requests

with open('image.jpg', 'rb') as image:
    response = requests.post(
        'https://removebgtool.net/v1.0/removebg',
        headers={'X-API-Key': 'YOUR_API_KEY'},
        files={'image_file': image},
        data={'size': 'auto'},
        timeout=180,
    )
response.raise_for_status()
with open('no-bg.png', 'wb') as output:
    output.write(response.content)

import { readFile, writeFile } from 'node:fs/promises';

const form = new FormData();
form.append('image_file', new Blob([await readFile('image.jpg')]), 'image.jpg');
form.append('size', 'auto');
const response = await fetch('https://removebgtool.net/v1.0/removebg', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: form,
  signal: AbortSignal.timeout(180000),
});
if (!response.ok) throw new Error(await response.text());
await writeFile('no-bg.png', Buffer.from(await response.arrayBuffer()));

Antwort

HTTP 200 liefert Bildbytes. Mit Accept: application/json erhältst du data.result_b64 und Bildmaße. Header: X-Width, X-Height, X-Credits-Charged, X-Foreground-Top/Left/Width/Height, X-Request-ID. Vordergrundkoordinaten beziehen sich auf die normalisierte Eingabeleinwand. Keine Klassifizierung und kein X-Type. GET /v1.0/account liefert data.attributes.credits sowie api.free_calls (0).

{
  "data": {
    "result_b64": "...",
    "result_width": 625,
    "result_height": 400,
    "credits_charged": 1
  }
}

Grenzen und Unterschiede

Eingabe: ≤22 MB, ≤50 MP, jede Seite 33–9999 Pixel, ein Bild in JPG/PNG/WebP. HTTPS-URLs müssen öffentlich, direkt und auf Port 443 erreichbar sein; Weiterleitungen und private Netze werden abgelehnt. Standard size=preview (0,25 MP); medium=1,5 MP, hd=4 MP, full/4k/auto=25 MP, 50MP=50 MP. PNG und auto sind auf 10 MP begrenzt. Keine Hochskalierung. Anders als bei remove.bg richtet sich auto nicht nach deinem Guthaben.

API-Aufrufe nutzen dein vorhandenes Guthaben. Die aktuelle Gebühr pro Bild steht im Dashboard und im Header X-Credits-Charged. Vorschau und volle Auflösung kosten gleich viel. Ein separates kostenloses monatliches API-Kontingent ist nicht enthalten.

Fehler und Wiederholungsversuche

400 ungültige Eingabe/Parameter · 402 zu wenig Credits · 403 ungültiger Schlüssel/Tarif · 409 Idempotenzkonflikt/laufend/abgelaufen · 415 nicht unterstützte Kodierung · 429 Ratenlimit · 502/503 Anbieterfehler/ausgelastet · 504 Zeitlimit. Beachte Retry-After bei 429/503, nutze exponentielles Backoff bei temporären 5xx-Fehlern und speichere Schlüssel nur serverseitig.

{
  "errors": [
    {
      "title": "Insufficient credits.",
      "code": "insufficient_credits"
    }
  ]
}

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.

Migrationscheckliste

1. Schlüssel in einem API-fähigen Tarif erstellen. 2. Domain ersetzen, /v1.0/removebg beibehalten. 3. Eingabegrenzen und nicht unterstützte Parameter prüfen. 4. Eigene Bilder, Fehlerbehandlung und Abrechnung testen. 5. Produktion umstellen. Dieser Dienst ist unabhängig von remove.bg.Migrationsleitfaden ansehen →

Eine kompatible Schnittstelle bedeutet nicht identische KI-Ergebnisse. Teste deine Bilder vor der Migration.