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/v1.0/removebg

POST deep-image.ai/rest_api/process_result

Nagłówek autoryzacji

X-Api-Key: <klucz remove.bg>

x-api-key: <klucz Deep-Image>

Odpowiedź

bajty obrazu

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

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

no-bg.pngbinarne bajty obrazu

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 header

Ten 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_urlurl

Dowolny publiczny URL obrazu.

image_file_b64url

Jako data URL: "data:image/jpeg;base64,…".

Tło

Co dzieje się z tłem

typebackground.remove

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

bg_colorbackground.color

Kod hex z # na początku ("#81d4fa") lub nazwa koloru ("white").

bg_image_urlbackground.replace

URL 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"} + padding

padding w pikselach (40) lub procentach ("10%").

sizewidth / height

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

Przed · 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
Po · 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

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.

Zdjęcie wejściowe, 512 na 512 pikseli
Wejście 512 × 512 px
Przezroczysty wycięty obiekt powiększony do 2048 na 2048 pikseli
Wycięcie 2048 × 2048 px
Żądanie
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"
  }'
Odpowiedź
{
  "status": "complete",
  "job": "c59857c0-c0a3-11f1-a1a1-9638fcd7d474",
  "result_url": "https://neuroapi-store.s3…/0254be37-….png"
}

Asynchronicznie z webhookiem

  1. Twoja aplikacja

    Wysyła POST do /rest_api/process z webhooks.complete.

  2. Deep-Image

    Od razu odpowiada identyfikatorem zadania i przetwarza obraz.

  3. Twój webhook

    Odbiera job, status i result_url.

  4. Pobieranie

    Pobierz result_url i zapisz obraz.

Żądanie
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 na Twój 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.

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