API-Leitfaden · Frist 1. Dezember 2026

Migration von der remove.bg-API

Die Self-Service-API von remove.bg nimmt ab dem 1. Dezember 2026 keine Anfragen mehr an. Hier finden Sie die remove.bg-Parameter mit ihren Entsprechungen bei Deep-Image und denselben Aufruf vorher und nachher.

Erstellen Sie ein kostenloses Konto und kopieren Sie Ihren Schlüssel unter Mein Profil → API. Jedes Beispiel auf dieser Seite wurde gegen die Live-API ausgeführt.

Auf einen Blick

Endpunkt

POST api.remove.bg/v1.0/removebg

POST deep-image.ai/rest_api/process_result

Auth-Header

X-Api-Key: <remove.bg-Schlüssel>

x-api-key: <Deep-Image-Schlüssel>

Antwort

Bildbytes

{"status": "complete", "result_url": …}

JSON mit einer Ergebnis-URL

Die eine Änderung, die jede Integration braucht: remove.bg antwortet mit der Bilddatei, Deep-Image antwortet mit JSON, und das Bild liegt unter result_url.

remove.bg

200 OK · image/png

no-bg.pngbinäre Bildbytes

Deep-Image

200 OK · application/json

{
  "status": "complete",
  "job": "c59857c0-…",
  "result_url": "https://…/no-bg.png"
}

Synchron · am nächsten an remove.bg

POST/rest_api/process_result

Wartet auf den Job (bis etwa 25 Sekunden) und gibt result_url zurück. Dauert es länger, ist status nicht complete: Fragen Sie das Ergebnis per Polling ab.

Asynchron · Batches

POST/rest_api/process

Antwortet sofort mit einer job-ID. Fügen Sie "webhooks": {"complete": "https://…"} hinzu, damit Ihnen das Ergebnis zugeschickt wird.

Polling

GET/rest_api/result/{job}

Gibt den Job-Status zurück und, sobald er abgeschlossen ist, seine result_url.

Basis-URL https://deep-image.ai/rest_api. Senden Sie JSON oder Multipart-Formulardaten mit dem Bild in einem beliebigen Dateifeld und den übrigen Parametern als JSON-String in einem Feld namens parameters.

Parameter-Zuordnung

Anfrage

Authentifizierung und wie das Bild gesendet wird

X-Api-Key headerx-api-key header

Gleicher Header; verwenden Sie Ihren Deep-Image-API-Schlüssel.

image_filemultipart file field (any name)

Weitere Parameter als JSON in einem Multipart-Feld namens parameters senden.

image_urlurl

Jede öffentliche Bild-URL.

image_file_b64url

Als Data-URL: "data:image/jpeg;base64,…".

Hintergrund

Was mit dem Hintergrund passiert

typebackground.remove

auto → "auto", person → "human", product / car / animal / transportation → "item".

bg_colorbackground.color

Hex-Wert mit führendem # ("#81d4fa") oder ein Farbname ("white").

bg_image_urlbackground.replace

URL des neuen Hintergrundbildes.

Ausgabe

Format, Bildausschnitt und Größe

formatoutput_format

"png", "jpg" oder "webp". Für Transparenz "png" oder "webp" verwenden.

crop + crop_marginfit: {"crop": "item"} + padding

padding in Pixeln (40) oder Prozent ("10%").

sizewidth / height

Die Ausgabe hat immer volle Auflösung. Setzen Sie width oder height zum Skalieren; ein größerer Wert skaliert im selben Aufruf hoch.

Vorher und nachher

Hintergrund aus einer lokalen Datei entfernen und als transparentes PNG speichern. Wählen Sie Ihre Sprache.

Vorher · remove.bg
curl -H "X-Api-Key: $REMOVE_BG_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -f https://api.remove.bg/v1.0/removebg -o no-bg.png
Nachher · Deep-Image
rm -f job.json
curl -sf https://deep-image.ai/rest_api/process_result \
  -H "x-api-key: $DEEP_IMAGE_API_KEY" \
  -F "image=@photo.jpg" \
  -F 'parameters={"background": {"remove": "auto"}, "output_format": "png"}' \
  -o job.json

if [ ! -s job.json ]; then
  echo "Request failed" >&2
elif [ "$(jq -r .status job.json)" = "complete" ]; then
  curl -sf -o no-bg.png "$(jq -r .result_url job.json)"
else
  echo "Still processing, poll GET /rest_api/result/$(jq -r .job job.json)"
fi

Hintergrund entfernen und hochskalieren

remove.bg kann nicht hochskalieren. Fügen Sie einer Anfrage zur Hintergrundentfernung width oder height hinzu, und das freigestellte Motiv wird im selben Job hochskaliert, für 1 Credit. Ein Prozentwert wie "400%" skaliert relativ zur Eingabe.

Eingabefoto, 512 × 512 Pixel
Eingabe 512 × 512 px
Transparent freigestelltes Motiv, hochskaliert auf 2048 × 2048 Pixel
Freisteller 2048 × 2048 px
Anfrage
curl -s https://deep-image.ai/rest_api/process_result \
  -H "x-api-key: $DEEP_IMAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://deep-image.ai/api-example2.jpg",
    "background": {"remove": "auto"},
    "width": 2048,
    "output_format": "png"
  }'
Antwort
{
  "status": "complete",
  "job": "c59857c0-c0a3-11f1-a1a1-9638fcd7d474",
  "result_url": "https://neuroapi-store.s3…/0254be37-….png"
}

Asynchron mit einem Webhook

  1. Ihre App

    Sendet POST an /rest_api/process mit webhooks.complete.

  2. Deep-Image

    Antwortet sofort mit einer Job-ID und verarbeitet dann das Bild.

  3. Ihr Webhook

    Empfängt job, status und result_url.

  4. Download

    result_url abrufen und das Bild speichern.

Anfrage
curl -s https://deep-image.ai/rest_api/process \
  -H "x-api-key: $DEEP_IMAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://deep-image.ai/api-example2.jpg",
    "background": {"remove": "auto", "color": "#ffffff"},
    "output_format": "jpg",
    "webhooks": {"complete": "https://example.com/deep-image-webhook"}
  }'
POST an Ihren Webhook
{
  "job": "ff4620ba-c0a3-11f1-ac5a-a63afc00aaa0",
  "status": "complete",
  "result_url": "https://neuroapi-store.s3…/result.jpg",
  "data": { … the parameters you sent … }
}

Kein öffentlicher Endpunkt?

Verzichten Sie auf den Webhook und fragen Sie den Job über seine job-ID ab, bis status den Wert complete hat; laden Sie dann result_url herunter.

Polling
curl -s https://deep-image.ai/rest_api/result/$JOB \
  -H "x-api-key: $DEEP_IMAGE_API_KEY"

Brauchen Sie Hilfe?

Unser Support-Team hilft bei Migrationen: Senden Sie uns Ihren aktuellen remove.bg-Aufruf, und wir antworten mit der Deep-Image-Entsprechung. Vollständige API-Referenz: documentation.deep-image.ai. Sie vergleichen Anbieter? Siehe Deep-Image vs. remove.bg.