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
POST deep-image.ai
Auth-Header
X-Api-Key:
x-api-key:
Antwort
Bildbytes
{"status": "complete",
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
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 headerGleicher 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_urlurlJede öffentliche Bild-URL.
image_file_b64urlAls Data-URL: "data:image/jpeg;base64,…".
Hintergrund
Was mit dem Hintergrund passiert
typebackground.removeauto → "auto", person → "human", product / car / animal / transportation → "item".
bg_colorbackground.colorHex-Wert mit führendem # ("#81d4fa") oder ein Farbname ("white").
bg_image_urlbackground.replaceURL 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"} + paddingpadding in Pixeln (40) oder Prozent ("10%").
sizewidth / heightDie 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.
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.pngrm -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)"
fiimport os
import requests
response = requests.post(
"https://api.remove.bg/v1.0/removebg",
headers={"X-Api-Key": os.environ["REMOVE_BG_API_KEY"]},
files={"image_file": open("photo.jpg", "rb")},
data={"size": "auto"},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
out.write(response.content)import json
import os
import requests
with open("photo.jpg", "rb") as image:
response = requests.post(
"https://deep-image.ai/rest_api/process_result",
headers={"x-api-key": os.environ["DEEP_IMAGE_API_KEY"]},
files={"image": image},
data={"parameters": json.dumps({
"background": {"remove": "auto"},
"output_format": "png",
})},
)
response.raise_for_status()
job = response.json()
if job["status"] == "complete":
result = requests.get(job["result_url"])
result.raise_for_status()
with open("no-bg.png", "wb") as out:
out.write(result.content)
else:
print("Still processing, poll GET /rest_api/result/" + job["job"])import { readFile, writeFile } from "node:fs/promises";
const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");
const response = await fetch("https://api.remove.bg/v1.0/removebg", {
method: "POST",
headers: { "X-Api-Key": process.env.REMOVE_BG_API_KEY },
body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
await writeFile("no-bg.png", Buffer.from(await response.arrayBuffer()));import { readFile, writeFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("parameters", JSON.stringify({
background: { remove: "auto" },
output_format: "png",
}));
const response = await fetch("https://deep-image.ai/rest_api/process_result", {
method: "POST",
headers: { "x-api-key": process.env.DEEP_IMAGE_API_KEY },
body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const job = await response.json();
if (job.status === "complete") {
const result = await fetch(job.result_url);
if (!result.ok) throw new Error(`download failed: ${result.status}`);
await writeFile("no-bg.png", Buffer.from(await result.arrayBuffer()));
} else {
console.log(`Still processing, poll GET /rest_api/result/${job.job}`);
}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.
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"
}'{
"status": "complete",
"job": "c59857c0-c0a3-11f1-a1a1-9638fcd7d474",
"result_url": "https://neuroapi-store.s3…/0254be37-….png"
}Asynchron mit einem Webhook
Ihre App
Sendet POST an /rest_api/process mit webhooks.complete.
Deep-Image
Antwortet sofort mit einer Job-ID und verarbeitet dann das Bild.
Ihr Webhook
Empfängt job, status und result_url.
Download
result_url abrufen und das Bild speichern.
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"}
}'{
"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.
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.
remove.bg, Photoroom, Canva und Leonardo.Ai sind Marken ihrer jeweiligen Inhaber. Deep-Image ist mit ihnen weder verbunden noch wird es von ihnen unterstützt. Preise und Limits der Wettbewerber wurden am 5. Oktober 2026 geprüft und können sich ändern.