Przewodnik API · termin 1 grudnia 2026 r.
Migracja z API remove.bg
Samoobsługowe API remove.bg przestaje przyjmować żądania 1 grudnia 2026 r. Poniżej znajdziesz parametry remove.bg z ich odpowiednikami w Deep-Image oraz to samo wywołanie przed zmianą i po niej.
Załóż darmowe konto i skopiuj klucz z zakładki Mój profil → API. Każdy przykład na tej stronie został uruchomiony na produkcyjnym API.
W skrócie
Endpoint
POST api.remove.bg
POST deep-image.ai
Nagłówek autoryzacji
X-Api-Key:
x-api-key:
Odpowiedź
bajty obrazu
{"status": "complete",
JSON z adresem wyniku
Jedyna zmiana potrzebna w każdej integracji: remove.bg odpowiada plikiem obrazu, a Deep-Image odpowiada JSON-em, w którym obraz jest pod result_url.
remove.bg
200 OK · image/png
Deep-Image
200 OK · application/json
{
"status": "complete",
"job": "c59857c0-…",
"result_url": "https://…/no-bg.png"
}Synchroniczny · najbliższy remove.bg
POST/rest_api/process_result
Czeka na zadanie (maksymalnie około 25 sekund) i zwraca result_url. Jeśli trwa to dłużej, status nie jest complete: odpytaj o wynik.
Asynchroniczny · przetwarzanie wsadowe
POST/rest_api/process
Od razu odpowiada identyfikatorem job. Dodaj "webhooks": {"complete": "https://…"}, aby otrzymać wynik na swój serwer.
Odpytywanie
GET/rest_api/result/{job}
Zwraca status zadania, a po jego zakończeniu także result_url.
Bazowy URL https://deep-image.ai/rest_api. Wyślij JSON albo dane multipart/form-data z obrazem w dowolnym polu pliku i pozostałymi parametrami jako tekstem JSON w polu o nazwie parameters.
Mapowanie parametrów
Żądanie
Autoryzacja i sposób wysłania obrazu
X-Api-Key headerx-api-key headerTen sam nagłówek; użyj swojego klucza API Deep-Image.
image_filemultipart file field (any name)Pozostałe parametry wyślij jako JSON w polu multipart o nazwie parameters.
image_urlurlDowolny publiczny URL obrazu.
image_file_b64urlJako data URL: "data:image/jpeg;base64,…".
Tło
Co dzieje się z tłem
typebackground.removeauto → "auto", person → "human", product / car / animal / transportation → "item".
bg_colorbackground.colorKod hex z # na początku ("#81d4fa") lub nazwa koloru ("white").
bg_image_urlbackground.replaceURL nowego obrazu tła.
Wynik
Format, kadrowanie i rozmiar
formatoutput_format"png", "jpg" lub "webp". Aby zachować przezroczystość, użyj "png" lub "webp".
crop + crop_marginfit: {"crop": "item"} + paddingpadding w pikselach (40) lub procentach ("10%").
sizewidth / heightWynik ma zawsze pełną rozdzielczość. Ustaw width lub height, aby zmienić rozmiar; większa wartość powiększa obraz w tym samym wywołaniu.
Przed i po
Usuń tło z lokalnego pliku i zapisz przezroczysty PNG. Wybierz swój język.
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}`);
}Usuń tło i powiększ obraz
remove.bg nie ma powiększania. Dodaj width lub height do żądania usunięcia tła, a wycięty obiekt zostanie powiększony w tym samym zadaniu, za 1 kredyt. Wartość procentowa, np. "400%", skaluje względem obrazu wejściowego.
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"
}Asynchronicznie z webhookiem
Twoja aplikacja
Wysyła POST do /rest_api/process z webhooks.complete.
Deep-Image
Od razu odpowiada identyfikatorem zadania i przetwarza obraz.
Twój webhook
Odbiera job, status i result_url.
Pobieranie
Pobierz result_url i zapisz obraz.
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 … }
}Nie masz publicznego endpointu?
Pomiń webhook i odpytuj zadanie po identyfikatorze job, aż status będzie równy complete, a potem pobierz result_url.
curl -s https://deep-image.ai/rest_api/result/$JOB \
-H "x-api-key: $DEEP_IMAGE_API_KEY"Potrzebujesz pomocy?
Nasz zespół wsparcia pomaga w migracjach: wyślij nam swoje obecne wywołanie remove.bg, a odpowiemy jego odpowiednikiem w Deep-Image. Pełna dokumentacja API: documentation.deep-image.ai. Porównujesz dostawców? Zobacz Deep-Image vs remove.bg.
remove.bg, Photoroom, Canva i Leonardo.Ai są znakami towarowymi ich właścicieli. Deep-Image nie jest z nimi powiązany ani przez nie rekomendowany. Ceny i limity konkurencji sprawdziliśmy 5 października 2026 r. i mogą się zmienić.