API remove.bg kończy działanie. Zmień jedną linijkę, zachowaj swój kod.
Samodzielna strona remove.bg i jej samoobsługowe API kończą działanie . API przechodzi do Leonardo.Ai (firmy należącej do Canva), co wymaga zmiany integracji (ogłoszenie Leonardo.Ai). removebackground.dev przyjmuje te same żądania: skieruj kod na nasz URL, użyj naszego klucza i gotowe.
Samoobsługowe API remove.bg kończy działanie
Jedyna linijka, która się zmienia
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgTen sam nagłówek X-Api-Key, z twoim kluczem removebackground.dev. Te same nazwy parametrów, te same nagłówki odpowiedzi, ten sam format błędów {"errors": [...]}.
Przed i po
Typowa integracja w czterech językach. Klucz pochodzi z REMOVEBG_API_KEY, więc jedyną zmianą jest wyróżniony URL.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Używasz Zapier, Make lub n8n?
Otwórz krok żądania HTTP, który wywołuje remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), zmień URL na https://removebackground.dev/v1.0/removebg, a wartość X-Api-Key na swój klucz removebackground.dev. Pozostałe pola zostaw bez zmian.
Zgodność parametrów
Wszystko, co wysyła twoje żądanie do remove.bg, jest akceptowane. Kilka opcji nie ma tu efektu, co zaznaczamy poniżej.
| Parametr | Status | Uwagi |
|---|---|---|
image_file / image_file_b64 / image_url | Obsługiwany | Treść multipart, urlencoded lub JSON. JPG, PNG lub WebP do 25 MB. |
size | Obsługiwany | auto, full, 4k i 50MP dają oryginalną rozdzielczość (do 25 MP); preview, small i regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Zawsze 1 kredyt. |
format | Obsługiwany | auto (PNG, jeśli jest przezroczystość, w przeciwnym razie JPG), png, jpg, webp i zip (color.jpg + alpha.png). |
crop / crop_margin | Obsługiwany | px lub % obiektu, 1–4 wartości w stylu CSS ("10% 20%" = pionowo, poziomo); maksymalnie 500px lub 50% na stronę. |
roi | Obsługiwany | "x1 y1 x2 y2" w px lub %: zachowywany jest tylko obiekt wewnątrz obszaru. |
scale / position | Obsługiwany | scale 10%–100% lub original; position center, original lub "x% y%". |
channels | Obsługiwany | rgba (wycięty obiekt) lub alpha (maska w skali szarości). |
bg_color | Obsługiwany | Hex z # lub bez (81d4fa) albo nazwa koloru. 8-cyfrowy hex zachowuje kolor i pomija jego kanał alfa. |
bg_image_url / bg_image_file | Obsługiwany | Wycięty obiekt jest nakładany na twój obraz tła, dopasowany (cover) do rozmiaru wyniku. |
Accept: application/json | Obsługiwany | Zwraca { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Akceptowany, ignorowany | Obiekt jest wykrywany automatycznie; X-Type ma zawsze wartość "other". |
semitransparency | Akceptowany, ignorowany | Miękkie krawędzie i półprzezroczyste obszary pochodzą wprost z maski modelu. |
shadow_type / shadow_opacity / add_shadow | Akceptowany, ignorowany | Cienie nie są dodawane. |
Długie żądania | Różnica | Czekamy do 110 sekund. Jeśli zdjęcie nie będzie wtedy gotowe, dostaniesz błąd 503, który można ponowić (bez opłaty, chyba że przetwarzanie się zakończyło). |
Nagłówki odpowiedzi
Udane wywołanie zwraca bajty obrazu (image/png, image/jpeg, image/webp lub application/zip) i te nagłówki. Wyślij Accept: application/json, aby zamiast tego otrzymać result_b64.
| Nagłówek | Znaczenie |
|---|---|
X-Width / X-Height | Rozmiar wyniku w pikselach. |
X-Credits-Charged | Kredyty zużyte przez to zdjęcie: zawsze 1 (nieudane kosztują 0). |
X-Type | Zawsze "other" (obiekt jest wykrywany automatycznie). |
X-Foreground-Top / -Left / -Width / -Height | Ramka obiektu w wyniku, w pikselach. |
X-Request-ID | Powtarza twój X-Request-ID lub wygenerowany identyfikator. Dodatkowy. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Jak czysta jest maska (0–1) i udział miękkich pikseli. Dodatkowy: przydaje się do oznaczania zdjęć do sprawdzenia. |
Błędy
| Status | Znaczenie |
|---|---|
400 | Nieprawidłowy parametr lub obraz (kody takie jak invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: doładuj konto na stronie cennika. |
403 | auth_failed: brak lub nieprawidłowy X-Api-Key. |
429 | rate_limit_exceeded. |
500 / 503 | Przetwarzanie nie powiodło się, przekroczono czas lub usługa jest chwilowo niedostępna. Ponów próbę; nieudane zdjęcia są darmowe. |
Saldo sprawdzisz przez GET https://removebackground.dev/v1.0/account: odpowiedź ma strukturę konta remove.bg. Wszystkie szczegóły w dokumentacji API.
Kredyty: 1 za zdjęcie i nigdy nie wygasają
Każde udane zdjęcie kosztuje 1 kredyt, niezależnie od rozmiaru i opcji. Nieudane zdjęcia są darmowe. Nowe konta dostają 50 darmowych kredytów na testy.
- Kredyty nigdy nie wygasająDoładuj raz, wykorzystaj w przyszłym tygodniu albo za rok.
- Bez subskrypcjiJednorazowe pakiety. Nic się nie odnawia.
- Nieudane zdjęcia są darmoweKredyt jest zużywany tylko wtedy, gdy tło zostanie usunięte.
Lista kontrolna migracji
- Pobierz klucz API removebackground.devZałóż konto (50 darmowych kredytów) i utwórz klucz na stronie konta.
- Zmień jedną linijkęSkieruj kod na https://removebackground.dev/v1.0/removebg i wstaw nowy klucz do tego samego nagłówka X-Api-Key.
- Przetestuj jedno zdjęcieWykonaj jedno prawdziwe żądanie i porównaj wynik z tym, co dostajesz dziś.
- Przełącz ruchWdróż przed 1 grudnia 2026 09:00 CET. Doładuj kredyty raz, nigdy nie wygasają.
Migracja z remove.bg: pytania
Czy remove.bg się zamyka?
Samodzielna strona remove.bg i jej samoobsługowe API kończą działanie 1 grudnia 2026 09:00 CET. API przechodzi do Leonardo.Ai (firmy należącej do Canva), co wymaga zmiany integracji. Źródło: ogłoszenie Leonardo.Ai pod adresem https://www.leonardo.ai/news/removebg-api-leonardo.
Jaki jest najprostszy zamiennik API remove.bg?
removebackground.dev ma endpoint zgodny z remove.bg. Zmień https://api.remove.bg/v1.0/removebg na https://removebackground.dev/v1.0/removebg, wyślij klucz removebackground.dev w tym samym nagłówku X-Api-Key i zachowaj resztę kodu: nazwy parametrów, nagłówki odpowiedzi i format błędów są takie same.
Czy muszę przepisać integrację przed grudniem 2026?
Nie. Żądania zachowują te same parametry (image_file, image_url, size, format, crop, bg_color…) i dostają ten sam rodzaj odpowiedzi: bajty obrazu z nagłówkami X-Width, X-Height i X-Foreground-* albo JSON z result_b64. Zmieniają się tylko URL i klucz.
Czy to działa z Zapier, Make lub n8n?
Tak. W kroku żądania HTTP (Zapier Webhooks, Make HTTP, n8n HTTP Request) zmień URL na https://removebackground.dev/v1.0/removebg, a wartość X-Api-Key na swój klucz removebackground.dev. Nic więcej się nie zmienia.
Ile to kosztuje?
1 kredyt za udane zdjęcie, niezależnie od rozmiaru i opcji. Bez subskrypcji: jednorazowe doładowania za 17 USD, 49 USD lub 99 USD, a kredyty nigdy nie wygasają. Nieudane zdjęcia są darmowe. Nowe konta dostają 50 darmowych kredytów.
Które parametry remove.bg są obsługiwane?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url i bg_image_file. type, type_level, semitransparency i opcje cienia są akceptowane i ignorowane, więc żądania, które je wysyłają, nadal działają.
Czy mogę sprawdzać saldo tak jak wcześniej?
Tak. GET https://removebackground.dev/v1.0/account z twoim kluczem zwraca kredyty w formacie konta remove.bg.
Czy removebackground.dev jest powiązany z remove.bg?
Nie. remove.bg jest znakiem towarowym swojego właściciela. removebackground.dev to niezależna usługa, która przyjmuje te same żądania API.
Przejdź przed 1 grudnia 2026 09:00 CET
Samoobsługowe API remove.bg kończy działanie
Utwórz klucz, zmień jedną linijkę, przetestuj jedno zdjęcie. 50 darmowych kredytów w zestawie.
remove.bg jest znakiem towarowym swojego właściciela. removebackground.dev nie jest z nim powiązany.